Coding

Influencer Campaign Monitoring (TikTok/IG/YouTube)

Try it

Monitor influencer campaigns across TikTok, Instagram, and YouTube: create and manage monitor tasks, pull metrics, download tracked assets, run post-campaign reviews. Campaign tracking, performance monitoring.

What it does

Monitor influencer campaigns across TikTok, Instagram, and YouTube: create and manage monitor tasks, pull metrics, download tracked assets, run post-campaign reviews. Campaign tracking, performance monitoring.

The skill document

Influencer Campaign Monitoring

Operate monitoring tasks and convert tracking data into actionable campaign review insights.

Capability Matrix

YouTube

CapabilityoperationIdInterfaceMinimum input
任务-视频下载youtube_task_video_downloadGET /api/v1/youtube/task/video/downloadquery.video_id
用户监控指标youtube_user_monitor_metricsGET /api/v1/youtube/user/monitor/metricsquery.channel_id

TikTok

CapabilityoperationIdInterfaceMinimum input
任务-视频下载tiktok_task_video_downloadGET /api/v1/tiktok/task/video/downloadquery.video_id
用户监控指标tiktok_user_monitor_metricsGET /api/v1/tiktok/user/monitor/metricsquery.unique_id

Instagram

CapabilityoperationIdInterfaceMinimum input
任务-视频下载instagram_task_video_downloadGET /api/v1/instagram/task/video/downloadquery.video_code
用户监控指标instagram_user_monitor_metricsGET /api/v1/instagram/user/monitor/metricsquery.username

Cross-platform

CapabilityoperationIdInterfaceMinimum input
创建视频监测任务create_monitor_taskPOST /api/v1/monitor/video/tasks/createbody.platform, body.video_id
获取视频监测任务详情get_monitor_task_detailGET /api/v1/monitor/video/tasks/detailquery.monitor_id
获取视频监测任务列表list_monitor_tasksGET /api/v1/monitor/video/tasks/listnone
手动刷新视频监测数据refresh_monitor_taskPOST /api/v1/monitor/video/tasks/refreshquery.monitor_id
停止视频监测任务stop_monitor_taskGET /api/v1/monitor/video/tasks/stopquery.monitor_id

Quick Start

  1. Identify monitoring scope (platform, creator/video, timeframe).
  2. Use Cross-platform matrix rows for task lifecycle operations.
  3. Use platform rows for metrics/download operations.
  4. Report trend, anomalies, and intervention actions.

Workflow

  1. Create or retrieve tasks (create_monitor_task, list_monitor_tasks, get_monitor_task_detail).
  2. Refresh/stop tasks as needed (refresh_monitor_task, stop_monitor_task).
  3. Pull platform metrics and tracked assets for campaign review.
  4. Summarize movement, anomalies, and next-step recommendation.

Tooling

Execution commands:

  • List operations: python3 scripts/execute_operation.py --env-file .env list
  • Create task: python3 scripts/execute_operation.py --env-file .env call --operation create_monitor_task --body '{"platform":"tiktok","video_id":"123456"}'
  • List tasks: python3 scripts/execute_operation.py --env-file .env call --operation list_monitor_tasks --query '{"page":1,"page_size":20}'

Required environment variables:

  • SCRUMBALL_BASE_URL: API gateway base URL
  • SCRUMBALL_API_KEY: unified API key
  • Optional: SCRUMBALL_AUTH_PREFIX, SCRUMBALL_TIMEOUT_SECONDS

Env loading:

  • Use --env-file .env for explicit loading.
  • Without --env-file, script auto-tries ./.env then /.env.

Output Contract

Always return:

  • Task status: active/completed/stopped + identifiers
  • Performance trend: key metric movement
  • Anomalies: unexpected spikes/drops
  • Recommendation: continue, adjust, or stop

Failure Handling

  • If task creation fails, validate platform and video identifier first.
  • If metric endpoints lag, report delayed freshness explicitly.
  • If user asks for audience-fit decisioning, hand off to audience-fit skill.

References

  • references/api-index.md: full operation index + platform grouped index
  • references/request-response.md: request parameters + response top-level/data fields + minimal examples
  • references/operations.json: operation manifest used by scripts/execute_operation.py

Quota & Unlock (important: act on 429)

  • Free tier: a limited number of calls per day, zero-config (no key required — the skill defaults to a hosted gateway that injects the key server-side).

  • When any operation returns HTTP 429, or the response body has code=429 / contains quota_exceeded, you (the assistant) MUST immediately and clearly tell the user (do not silently retry, do not treat it as a generic error):

    Free quota exhausted. Register and get your own API key at https://data.scdata.cc/pricing, then set the environment variable SCRUMBALL_API_KEY to your key (in your host/agent environment or a local .env). You can then continue with your own quota.

  • The 429 response body usually includes apply_url and env_var fields you can quote directly.

Related skills

Find influencers and creators across TikTok, Instagram, and YouTube by keyword; expand similar creators, enrich profiles, and build outreach-ready lead lists. Influencer search, creator discovery, KOL sourcing.

Fetch fresh, on-demand creator data across TikTok, Instagram, Facebook, and YouTube: page/profile info, latest videos, posts, and media details. Realtime creator data, profile lookup, content details.

Builds a comprehensive social media audit for a brand across all major platforms using apidojo's multi-platform scrapers. Triggers when the user asks to: do a social media audit for a brand, build a full social media presence report, analyze a brand's performance across all social platforms, create a cross-platform social media benchmark, audit a competitor's entire social media strategy, build a social media scorecard for a brand, or create a comprehensive social media analysis covering Twitter Instagram TikTok and YouTube. Returns per-platform metrics, follower counts, engagement rates, content mix, posting frequency, and overall brand health score. Ideal for social media managers, brand strategists, and agency teams doing comprehensive brand audits.

1 installs

Monitors TikTok for brand mentions and product discussions using apidojo's TikTok scraper on Apify. Triggers when the user asks to: track mentions of a brand on TikTok, monitor TikTok hashtags for brand content, find TikTok videos talking about a product or company, see what TikTok says about a brand this week, track TikTok reactions to a product launch, find TikTok creators who mentioned a competitor brand, monitor brand sentiment on TikTok, or discover viral TikTok content about a specific brand or product. Returns creator handle, views, likes, comments, sentiment signal, and video caption excerpt. Ideal for brand managers, community teams, crisis communications, and product marketing teams.

1 installs

Discovers brand collaboration patterns and sponsored content on TikTok using apidojo's TikTok scrapers on Apify. Triggers when the user asks to: find which brands are running TikTok influencer campaigns, discover creator-brand partnerships in a product category, identify which influencers are working with competitor brands on TikTok, see what sponsorship deals are active in a niche, find brands that sponsor TikTok creators, analyze competitor influencer marketing strategy on TikTok, or track paid partnership posts by category. Returns creator handle, brand name, post performance, estimated reach, and collaboration frequency. Ideal for influencer marketing teams, competitive intelligence analysts, and brand partnership managers.

1 installs

Use when the user asks to "analyze influencer campaign performance", "compare influencers", or "find what content worked"; produces metric scorecards vs targ...