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.
Design & media
Realtime Creator Data (TikTok/IG/FB/YouTube)
Try itFetch 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.
What it does
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.
The skill document
Influencer Realtime Enrichment
Fetch fresh creator and content data when snapshot data is not enough for current decisions.
Capability Matrix
YouTube
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 实时采集-用户信息 | youtube_realtime_user_info | GET /api/v1/youtube/realtime/user/info | query.anyOf(channel_id,username) |
| 实时采集-用户视频 | youtube_realtime_user_videos | GET /api/v1/youtube/realtime/user/videos | query.channel_id |
| 实时采集-视频详情 | youtube_realtime_video_detail | GET /api/v1/youtube/realtime/video/detail | query.video_id |
TikTok
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 实时采集-用户信息 | tiktok_realtime_user_info | GET /api/v1/tiktok/realtime/user/info | query.anyOf(unique_id,user_id) |
| 实时采集-用户视频 | tiktok_realtime_user_videos | GET /api/v1/tiktok/realtime/user/videos | query.uid |
| 实时采集-视频详情 | tiktok_realtime_video_detail | GET /api/v1/tiktok/realtime/video/detail | query.video_id, query.region |
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 实时采集-贴文详情 | instagram_realtime_media_detail | GET /api/v1/instagram/realtime/media/detail | query.media_code |
| 实时采集-用户信息 | instagram_realtime_user_info | GET /api/v1/instagram/realtime/user/info | query.anyOf(username,user_id) |
| 实时采集-用户贴文 | instagram_realtime_user_medias | GET /api/v1/instagram/realtime/user/medias | query.user_id |
| 实时采集-用户故事 | instagram_realtime_user_stories | GET /api/v1/instagram/realtime/user/stories | query.user_id |
Cross-platform
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
none | none | none | none |
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 实时挖掘-页面信息 | facebook_page_info | GET /api/v1/facebook/realtime/page/info | query.page_url |
| 实时挖掘-帖子详情 | facebook_post_detail | GET /api/v1/facebook/realtime/post/detail | query.post_url |
| 任务-关键词搜索帖子 | facebook_task_post_search | GET /api/v1/facebook/task/post/search | query.query |
| 任务-页面帖子 | facebook_task_page_posts | GET /api/v1/facebook/task/page/posts | query.page_url |
| 任务-查询结果 | facebook_task_result | GET /api/v1/facebook/task/result | query.task_id |
Quick Start
- Confirm freshness requirement and urgency window.
- Choose platform and target object type (user/media/video/story).
- Use matrix to select realtime detail/list endpoints.
- Return delta-oriented findings and campaign impact.
Workflow
- Define enrichment target: creator-level or content-level.
- Execute realtime retrieval with minimal required identifiers.
- Compare new payload against prior assumptions and summarize deltas.
- Flag impact and next monitoring action.
Tooling
Execution commands:
- List operations:
python3 scripts/execute_operation.py --env-file .env list - Example user enrichment:
python3 scripts/execute_operation.py --env-file .env call --operation tiktok_realtime_user_info --query '{"unique_id":"nike"}' - Example content enrichment:
python3 scripts/execute_operation.py --env-file .env call --operation youtube_realtime_video_detail --query '{"video_id":"dQw4w9WgXcQ"}'
Required environment variables:
SCRUMBALL_BASE_URL: API gateway base URLSCRUMBALL_API_KEY: unified API key- Optional:
SCRUMBALL_AUTH_PREFIX,SCRUMBALL_TIMEOUT_SECONDS
Env loading:
- Use
--env-file .envfor explicit loading. - Without
--env-file, script auto-tries./.envthen/.env.
Output Contract
Always return:
Freshness: retrieval time and target objectKey deltas: metric-level differences vs prior expectationImpact: why the delta matters for decisionsNext step: monitor, replace creator, or continue
Failure Handling
- If platform identifiers are missing, request minimal required ID.
- If realtime endpoint returns no data, retry once and report fallback.
- If user asks for long-range historical trend, hand off to monitoring skill.
References
references/api-index.md: full operation index + platform grouped indexreferences/request-response.md: request parameters + response top-level/data fields + minimal examplesreferences/operations.json: operation manifest used byscripts/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/ containsquota_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_KEYto 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_urlandenv_varfields you can quote directly.
Related skills
Discovers and ranks TikTok creators in any niche or topic using apidojo's TikTok scrapers on Apify. Triggers when the user asks to: find TikTok influencers in a specific niche, discover creators for a campaign, identify who's growing fastest on TikTok in a category, find micro-influencers on TikTok under a certain follower count, build a list of TikTok creators for brand partnerships, compare TikTok creator engagement rates in a vertical, or identify rising TikTok stars. Returns creator username, follower count, avg views, engagement rate, bio, and profile URL. Ideal for influencer marketers, brand partnership teams, and talent managers.
1 installs
Scrapes detailed TikTok user data and recent video history using apidojo's TikTok User scraper on Apify. Triggers when the user asks to: get all videos from a TikTok account, fetch a TikTok creator's recent posts and stats, export a TikTok user's video history, scrape all TikTok content from a specific creator, get TikTok post data by username, or collect video-level metrics from a TikTok profile. Returns per-video view count, likes, comments, shares, captions, and timestamps for a given account. Ideal for creator analysis, content auditing, and competitive benchmarking.
1 installs
Collect public videos from a TikTok creator with Gecho Bridge MCP. Returns video metadata, captions, engagement metrics, publish times, and links. Requires the Gecho Chrome extension, an active TikTok session, and the Gecho Bridge MCP server.
Build an influencer shortlist from a category, budget, and market, or from account links and handles you already have. This influencer analysis and creator matching workflow reads public creator profiles and recent posts on TikTok, Douyin, Xiaohongshu, Instagram, YouTube, and X, or works from bios, follower counts, and posts you paste, then writes an 8-12 person memo with followers, recent play, interaction, content pillars, and a talk-or-not call. Use it for influencer analysis, creator matching, influencer shortlist, and creator research when you need who to approach for a campaign or collab.
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.