Brand & Social Listening

UGC Advocate & Creator Finder

Surface the happiest creators posting about your brand across Instagram, TikTok and X — handing back follower counts and contact emails

What it does

Filtering branded posts to positive/joy/trust sentiment isolates genuine advocates; enriching each Instagram author's profile turns praise into a contactable, reach-ranked outreach list, while optional TikTok and X passes widen the advocate pool onto the networks where UGC actually lives.

Who it's for: Influencer and community marketers building a UGC and creator pipeline

Inputs

How your agent runs it

1. 1
   search_instagram

   search_instagram(query={brand}, pages=5, get_sentiment=true)

   Keep only posts whose polarity is positive or dominant_emotion is joy/trust, and collect the author usernames.

2. 2
   instagram_user_profile

   instagram_user_profile(username=<positive_author>)

   Enrich each advocate with followers, category, public_email, and external_url.

3. 3
   search_instagram_users

   search_instagram_users(query={brand})

   Find fan, affiliate, and lookalike accounts the post search missed and add their handles to the pool.

4. 4
   instagram_user_profile

   instagram_user_profile(url=<fan_account_url>)

   Enrich those accounts too, then rank everyone by followers and flag the ones with a public_email as outreach-ready.

5. 5
   search_tiktok

   search_tiktok(query={brand}, pages=5, get_sentiment=true, sort_by=most_liked)

   Only run if {platforms} includes tiktok: pull TikTok posts about the brand, keep posts whose sentiment is positive or joy/trust, collect the creator handles, and rank them by likes as a reach proxy. Pass region only if the user supplied one, otherwise omit it for a global search.

6. 6
   search_twitter

   search_twitter(query={brand}, pages=5, get_sentiment=true, sort_by=relevance)

   Only run if {platforms} includes twitter: pull X posts about the brand, keep the positive ones, collect the highest-engagement accounts plus any bio link in their results, and merge them into the final reach-ranked outreach shortlist.

Tools used

The full playbook

This is exactly what the MCP returns to your agent (via the ugc-advocate-creator-finder prompt or get_skill tool), with your inputs filled in.

SKILL: UGC Advocate & Creator Finder
Filtering branded posts to positive/joy/trust sentiment isolates genuine advocates; enriching each Instagram author's profile turns praise into a contactable, reach-ranked outreach list, while optional TikTok and X passes widen the advocate pool onto the networks where UGC actually lives.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - brand (required): <brand — ASK THE USER>
      Brand name or campaign keyword (no @ or # prefix)
  - platforms (optional): (optional — e.g. instagram, tiktok, twitter)
      Comma-separated list of platforms to run — options: instagram, tiktok, twitter. Omit to run all of them; name specific platforms to limit the run.
  - result_depth (optional): 5 (default — override if you like)
      How many pages to scan per search (1-5). Higher surfaces more candidates at the cost of more calls. Maps to the pages param on every search step. Defaults to 5.
  - region (optional): (optional — e.g. US)
      Optional country/region code to focus the TikTok advocate pass on a target market; omit for global. Only affects the TikTok step.

PLATFORM SELECTION: some steps are gated with "Only run if {platforms} includes X". If the user supplied a `platforms` value, run only the steps whose platform is listed. If the user did NOT supply `platforms`, run ALL steps — every platform the skill supports.

STEPS:
  1. Tool `search_instagram` — search_instagram(query={brand}, pages=5, get_sentiment=true)
     Keep only posts whose polarity is positive or dominant_emotion is joy/trust, and collect the author usernames.
  2. Tool `instagram_user_profile` — instagram_user_profile(username=<positive_author>)
     Enrich each advocate with followers, category, public_email, and external_url.
  3. Tool `search_instagram_users` — search_instagram_users(query={brand})
     Find fan, affiliate, and lookalike accounts the post search missed and add their handles to the pool.
  4. Tool `instagram_user_profile` — instagram_user_profile(url=<fan_account_url>)
     Enrich those accounts too, then rank everyone by followers and flag the ones with a public_email as outreach-ready.
  5. Tool `search_tiktok` — search_tiktok(query={brand}, pages=5, get_sentiment=true, sort_by=most_liked)
     Only run if {platforms} includes tiktok: pull TikTok posts about the brand, keep posts whose sentiment is positive or joy/trust, collect the creator handles, and rank them by likes as a reach proxy. Pass region only if the user supplied one, otherwise omit it for a global search.
  6. Tool `search_twitter` — search_twitter(query={brand}, pages=5, get_sentiment=true, sort_by=relevance)
     Only run if {platforms} includes twitter: pull X posts about the brand, keep the positive ones, collect the highest-engagement accounts plus any bio link in their results, and merge them into the final reach-ranked outreach shortlist.

DELIVER: A reach-ranked, cross-platform shortlist of positive brand creators (Instagram plus optional TikTok and X) with follower counts, category, and a public email or bio link for direct outreach.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.