Brand & Social Listening
UGC Advocate & Creator Finder
Surface the happiest creators posting about your brand and hand back their follower count and contact email
https://apidirect.io/mcp?token=YOUR_API_KEY
Find me Instagram creators who love {brand} and give me their follower counts and emails
ugc-advocate-creator-finder.
Any agent can also call get_skill(skill_id="ugc-advocate-creator-finder") to pull these steps on demand.
What it does
Filtering branded Instagram posts to positive/joy/trust sentiment isolates genuine advocates, and enriching each author's profile turns a feed of praise into a contactable, reach-ranked outreach list.
Who it's for: Influencer and community marketers building a UGC and creator pipeline
Inputs
| Input | Required | Description | Example |
|---|---|---|---|
brand |
Yes | Brand name or campaign keyword (no @ or # prefix) | Glossier |
How your agent runs it
-
1
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
instagram_user_profile(username=<positive_author>)Enrich each advocate with followers, category, public_email, and external_url.
-
3
search_instagram_users(query={brand})Find fan, affiliate, and lookalike accounts the post search missed and add their handles to the pool.
-
4
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.
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 Instagram posts to positive/joy/trust sentiment isolates genuine advocates, and enriching each author's profile turns a feed of praise into a contactable, reach-ranked outreach list.
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>
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.
DELIVER: A reach-ranked shortlist of positive brand creators with follower counts, category, and public email or website 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.