Use this skill when a user needs KOL or influencer research, creator email lookup, similar-creator discovery, outreach-list building, influencer prospecting,...
1 次安装
文档
TikTok/Instagram/YouTube Influencer Discovery
试用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.
它能做什么
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.
技能文档
Influencer Lead Discovery
Build decision-ready creator shortlists across TikTok, Instagram, and YouTube with explicit operation-level mapping.
Capability Matrix
YouTube
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 搜索youtube用户 | search_youtube_user | POST /api/v1/search/youtube/user | body.query |
| 搜索youtube视频 | search_youtube_video | POST /api/v1/search/youtube/video | body.query |
| 合作品牌 | youtube_user_brands | GET /api/v1/youtube/user/brands | query.channel_id |
| 用户top10 hashtag互动数据 | youtube_user_hashtag_engagement | GET /api/v1/youtube/user/hashtag/engagement | query.channel_id |
| 用户信息 | youtube_db_user_info | GET /api/v1/youtube/user/info | query.anyOf(channel_id,username) |
| 相似用户推荐 | youtube_user_similar | GET /api/v1/youtube/user/similar | query.anyOf(channel_id,channel_handle) |
| 用户视频 | youtube_db_user_videos | GET /api/v1/youtube/user/videos | query.channel_id |
TikTok
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 搜索tiktok用户 | search_tiktok_user | POST /api/v1/search/tiktok/user | body.query |
| 搜索tiktok视频 | search_tiktok_video | POST /api/v1/search/tiktok/video | body.query |
| 合作品牌 | tiktok_user_brands | GET /api/v1/tiktok/user/brands | query.unique_id |
| 用户top10 hashtag互动数据 | tiktok_user_hashtag_engagement | GET /api/v1/tiktok/user/hashtag/engagement | query.unique_id |
| 用户信息 | tiktok_db_user_info | GET /api/v1/tiktok/user/info | query.unique_id |
| 相似用户推荐 | tiktok_user_similar | GET /api/v1/tiktok/user/similar | query.unique_id |
| 用户视频 | tiktok_db_user_videos | GET /api/v1/tiktok/user/videos | query.unique_id |
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| 合作品牌 | instagram_user_brands | GET /api/v1/instagram/user/brands | query.username |
| 用户top10 hashtag互动数据 | instagram_user_hashtag_engagement | GET /api/v1/instagram/user/hashtag/engagement | query.username |
| 用户信息 | instagram_db_user_info | GET /api/v1/instagram/user/info | query.username |
| 用户贴文 | instagram_db_user_medias | GET /api/v1/instagram/user/medias | query.username |
| 相似用户推荐 | instagram_user_similar | GET /api/v1/instagram/user/similar | query.username |
| 搜索instagram帖文 | search_instagram_media | POST /api/v1/search/instagram/media | body.query |
| 搜索instagram用户 | search_instagram_user | POST /api/v1/search/instagram/user | body.query |
Cross-platform
| Capability | operationId | Interface | Minimum input |
|---|---|---|---|
| ping | ping | GET /api/ping | none |
| 搜索联想 | search_instagram_suggest | POST /api/v1/search/suggest | query.platform, query.query |
Quick Start
- Confirm campaign objective, target market, and primary platform.
- Use the Capability Matrix to choose operationIds by platform and task.
- Check
references/request-response.mdfor required params and response field layout. - Run
scripts/execute_operation.pycalls and rank candidates with evidence.
Workflow
- Build candidate pools first (
search_*) and expand pagination for coverage. - Enrich shortlisted creators (
*_db_user_info,*_db_user_videos/*_db_user_medias,*_user_similar). - Add partnership relevance signals (
*_user_brands,*_user_hashtag_engagement) before ranking. - Return a shortlist with explicit reasons, risks, and next actions.
Tooling
Execution commands:
- List operations:
python3 scripts/execute_operation.py --env-file .env list - Filter by tag:
python3 scripts/execute_operation.py --env-file .env list --tag search - Example search:
python3 scripts/execute_operation.py --env-file .env call --operation search_tiktok_user --body '{"query":"nike","page":1,"page_size":10}' - Example enrich:
python3 scripts/execute_operation.py --env-file .env call --operation tiktok_db_user_info --query '{"unique_id":"nike"}'
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:
Top candidates: ordered list with platform + identifierWhy selected: 2-3 evidence points per candidateRisks: data gaps or quality caveatsNext step: outreach/testing recommendation
Failure Handling
- If required IDs are missing, request only minimal fields from the user.
- If no results, relax one filter at a time and report what changed.
- If API fails, include failed
operationIdand retry guidance.
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.
相关技能
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 次安装
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.
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 次安装
Discovers potential brand ambassadors across Instagram TikTok and Twitter using apidojo's scrapers. Triggers when the user asks to: find brand ambassadors across multiple platforms, discover cross-platform creators for brand ambassador programs, find creators who would make good ambassadors across social media, identify multi-platform influencers for ambassador recruitment, find creators with audiences on multiple platforms for a brand partnership, build a multi-platform brand ambassador pipeline, or discover creators with authentic brand affinity across channels. Returns creator handle per platform, combined reach estimate, brand affinity signals, engagement metrics, and ambassador tier. Ideal for brand partnership teams, DTC brands, and ambassador program managers needing multi-channel reach.
1 次安装
Finds gaming content creators on TikTok and YouTube using apidojo's scrapers on Apify. Triggers when the user asks to: find gaming influencers for brand campaigns, discover streamers or gaming YouTubers in a specific game or genre, find TikTok creators posting gaming content, identify gaming micro-influencers for product sponsorships, find gaming creators who review hardware or accessories, build a gaming creator outreach list for a gaming brand or peripheral company, or discover rising gaming creators before they go mainstream. Returns creator handle, platform, subscriber count, avg views, game focus, and engagement signals. Ideal for gaming peripheral brands, energy drink sponsors, game publishers, and esports orgs.
1 次安装