apidojo-io/apidojo-skills

finding-brand-ambassador-candidates

Finds brand ambassador candidates on Instagram and TikTok using apidojo's scrapers on Apify.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/apidojo-io/apidojo-skills --skill finding-brand-ambassador-candidates

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

Finding Brand Ambassador Candidates

Identifies creators who already post about a brand or product organically — these are the highest-converting ambassador recruits because their content is authentic and their audience trusts them.

Prerequisites

  • APIFY_TOKEN environment variable set
  • Optional: Apify MCP server installed

Inputs

ParameterTypeRequiredDefaultNotes
startUrlsarray✅[]Instagram URLs — profiles, hashtags, locations, audio pages, reels
untilstringOptional—Scrape posts until this date (YYYY-MM-DD)
maxItemsnumberOptionalUnlimitedMaximum posts to return
customMapFunctionstringOptional—JavaScript function to transform each output object

Workflow

Progress:
- [ ] Step 1: Search brand hashtags on both platforms
- [ ] Step 2: Identify repeat posters
- [ ] Step 3: Score ambassador fit
- [ ] Step 4: Check for competing partnerships
- [ ] Step 5: Deliver ranked ambassador pipeline

Step 1: Search Brand Mentions

Instagram:

Tool: apify:run-actor
Actor: "apidojo~instagram-scraper"
Input: {"keywords": ["#[brand]", "#[brand]review", "#[brand]community", "#[brandproduct]"], "maxItems": 200}

TikTok:

Tool: apify:run-actor
Actor: "apidojo~tiktok-scraper"
Input: {"keywords": ["#[brand]", "#[brand]review", "#[brand]tiktokmademebuyit"], "maxItems": 300}

Recommended — run_actor.js (handles waiting, output, and file saving automatically):

bash
# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~instagram-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~instagram-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~instagram-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json
APIFY_TOKEN must be set in environment or .env file.

REST API fallback:

bash
# Instagram
curl -X POST "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs?token=$APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"keywords": ["#[brand]", "#[brand]review"], "maxItems": 200}'

Step 2: Score Ambassador Fit

For each repeat poster (appeared ≥ 2 times):

ambassador_score = (post_count / 5) * 0.25                             # organic depth
                 + (engagement_rate / 5.0) * 0.30                      # audience quality
                 + (has_competing_sponsor ? 0 : 1) * 0.25              # exclusivity signal
                 + (follower_count in 1000..50000 ? 1 : 0.6) * 0.20   # partnership tier

Competing sponsor check: Scan last 20 posts for #ad or #sponsored with a brand that competes in the same category. If found: has_competing_sponsor = true.

Step 3: Edge Cases

  • Brand's own reposts appear in hashtag: Drop posts where ownerUsername = brand account
  • Repeat poster is a bot: Check: ratio of followers/following ≤ 0.1 AND recent posts are all different brands — likely a spam/bot account
  • Low brand mention specificity: Creator mentions the brand once in passing — not a genuine advocate; require at least one post that is primarily about the brand
  • Creator already in ambassador program: No reliable way to detect this via scraping; note this as a known limitation — outreach will reveal it

Output Format

# Brand Ambassador Pipeline: [BRAND/PRODUCT]
Creators found: [N] | Repeat advocates: [N] | High-fit: [N] | Date: [DATE]

## Tier 1 — High-Fit Ambassadors (Multiple Organic Posts)
| Creator | Platform | @Handle | Followers | Eng Rate | Brand Posts | Competing Sponsor | Score |
|---------|---------|---------|-----------|----------|------------|------------------|-------|
| [name] | IG/TT | @[handle] | [N] | [X%] | [N] | [Yes/No] | [0.XX] |

## Tier 2 — Early Advocates (1-2 Brand Posts)
| Creator | Platform | Followers | Brand Posts | Eng Rate |
|---------|---------|-----------|------------|----------|

## Outreach Angle
For each Tier 1 creator, note: their most engaging brand post — reference it in outreach.

Troubleshooting

Brand hashtag has too few posts: Brand may have low organic social presence — search product category hashtags and look for anyone mentioning brand by name in caption. All high-fit creators already have competing sponsors: Indicates the category is saturated. Consider offering an exclusive deal to a mid-tier creator to lock out competition. No repeat posters found: Brand lacks loyal vocal advocates — this itself is a finding. Consider product seeding to build an organic advocate base before formal ambassador program launch.

タスクに関連する項目

同じリポジトリから

関連する Skills

すべての Skills
apidojo-io
コミュニティ

discovering-tiktok-creators-by-niche

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

1時間の導入数
2
GitHub Stars
1
更新日
5月13日
apidojo-io
コミュニティ

finding-gaming-content-creators

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 c

1時間の導入数
2
GitHub Stars
1
更新日
5月13日
apidojo-io
コミュニティ

scraping-instagram-posts-by-hashtag

Scrapes Instagram posts for any hashtag using apidojo's Instagram scraper on Apify. Triggers when the user asks to: get Instagram posts for a hashtag, scrape Instagram content by tag, export Instagram post data for a keyword or topic, fetch posts under an Instagram challenge or trend, collect Instagram media for a specific tag, or download Instagram post metadata by hashtag. Returns post URL, caption, like count, comment count, author handle, and timestamp per post. Ideal for trend analysts, UGC

1時間の導入数
2
GitHub Stars
1
更新日
5月13日
apidojo-io
コミュニティ

scraping-tiktok-profile-data

Scrapes TikTok profile statistics and metadata for any list of accounts using apidojo's TikTok Profile scraper on Apify. Triggers when the user asks to: get TikTok profile stats for an account, fetch follower count and engagement data for TikTok users, scrape TikTok account metadata in bulk, export TikTok profile information for a list of creators, check TikTok stats for multiple usernames, or get bio and follower data from TikTok profiles. Returns username, follower count, following count, tota

1時間の導入数
1
GitHub Stars
1
更新日
5月13日