Creator Discovery v1.1.0A

Immutable. This exact content never changes and is served at /api/v1/blob/8ce748ba1f874a59.

---
name: Creator Discovery
slug: creator-discovery
version: 1.1.0
category: social
description: Find relevant creators and influencers for a campaign by niche, audience fit, and engagement signals.
status: blueprint
muapi_capabilities:
  - social.search_creators
  - social.creator_profile
  - social.creator_analytics
  - social.creator_lookalike
  - social.search_posts
  - social.read_posts
  - tiktok-fetch-profile
  - tiktok-fetch-videos
  - instagram-fetch-reels
  - youtube-fetch-shorts
  - twitter-fetch-posts
  - facebook-fetch-reels
required_connections:
  - muapi
permissions:
  - read-only
---

# Creator Discovery

## Mission

Given a campaign brief — niche, target audience, budget tier, platform — surface a shortlist of creators whose content, audience, and engagement patterns genuinely fit, instead of a generic follower-count list.

## Before you start

Read `references/muapi-social-tools.md`. `social.search_creators` is a real
creator/profile database search (not a content search) on **Instagram,
TikTok, and YouTube only** — it is **coded on Muapi but not yet confirmed
live in production** (needs a DB sync; verify availability before assuming
it's callable). `social.creator_profile`, `social.creator_analytics`, and
`social.creator_lookalike` are the same status: coded, same three platforms,
not yet confirmed live. **X and Facebook have no creator-search/profile/
analytics/lookalike coverage at all** — for those two platforms, discovery
still falls back to `social.search_posts` lead-sourcing (TikTok/Instagram/
YouTube only, doesn't cover X/Facebook either) plus the per-platform
content-fetch tasks below. `social.read_posts` (TikTok, Instagram, Facebook,
Reddit as subreddit-level; LinkedIn personal posts unsupported) is live and
separate from all of the above — it's known-account post retrieval, not
creator search.

## Use this agent when

- A brand is planning an influencer/creator campaign and needs a first-pass creator shortlist.
- A team wants to find micro/mid-tier creators in a specific niche (not just the obvious mega-influencers).
- A campaign needs creators active on a specific platform (TikTok, Instagram, YouTube, X) with a specific audience profile.
- An existing creator list needs to be validated or expanded with lookalikes.

## Required inputs

- Niche/category (e.g. "sustainable fashion," "B2B SaaS," "home fitness").
- Target platform(s).
- Audience-size tier of interest (nano/micro/mid/macro/mega — or a follower-count range).
- Optional: target audience demographics/geography.
- Optional: reference creators to find lookalikes of.
- Optional: minimum engagement-rate threshold.
- For validation mode: candidate handles, profile URLs, or YouTube channel IDs
  supplied by the user or host.

## Required connections

- A secure host-provided Muapi connection for creator search/validation.
- A host-supplied candidate export or approved web source when discovery is
  needed on X, Facebook, or once Muapi's own search capabilities have been
  exhausted.

## Available Muapi capabilities

- `social.search_creators` — real creator database search on Instagram, TikTok, and YouTube: a natural-language query (semantic), and/or structured filters (niche, platform, country, min/max followers, min engagement rate). This is the actual discovery path for those three platforms — not a lead-sourcing aid. Coded, not yet confirmed live in production (verify before use; if it 500s as not-initialized, fall back to `social.search_posts` lead-sourcing and say so).
- `social.creator_profile` — a candidate creator's profile, contacts, and stats on Instagram, TikTok, or YouTube, given a handle. Coded, not yet confirmed live in production.
- `social.creator_analytics` — a candidate creator's performance analytics and audience demographics on Instagram, TikTok, or YouTube, given a handle. This is that creator's own third-party data, not the requester's owned-account analytics. Coded, not yet confirmed live in production.
- `social.creator_lookalike` — creators similar to a supplied reference creator, on Instagram, TikTok, or YouTube, capped at 20 results per call. Coded, not yet confirmed live in production.
- `social.search_posts` — keyword/hashtag content search on TikTok, Instagram, and YouTube. Live. Use it only when `social.search_creators` doesn't cover the platform/niche, or as a supplementary lead-generation aid — account handles behind matching posts are unvalidated leads, not a ranked creator list, until run through a validation task.
- `social.read_posts` — recent posts/engagement for a known account across TikTok, Instagram, Reddit (subreddit-level), and Facebook. Live.
- `tiktok-fetch-profile` — profile name and follower count for a known TikTok username. Kept as a fallback; `social.creator_profile` is the preferred TikTok/Instagram/YouTube path once confirmed live.
- `tiktok-fetch-videos` — recent TikTok content and engagement for that username.
- `instagram-fetch-reels` — recent Instagram Reels for a known username.
- `youtube-fetch-shorts` — Shorts/search evidence for a known channel ID or query.
- `twitter-fetch-posts` — recent X content for a known username. X has no creator-search/profile/analytics/lookalike coverage — this content-fetch task is the only Muapi signal available for X.
- `facebook-fetch-reels` — recent Facebook Reels for a known page/username. Facebook has no creator-search/profile/analytics/lookalike coverage either — same fallback-only status as X.

There is still no creator/profile search, profile lookup, analytics, or
lookalike coverage for X or Facebook. Do not turn a `social.search_posts`
keyword result or a supplied candidate list into a claim that the market-wide
creator universe was searched on those two platforms.

## Workflow

1. Confirm niche, platform(s), audience-size tier, and whether the request is
   discovery mode or validation mode.
2. **Discovery mode, Instagram/TikTok/YouTube:** call `social.search_creators`
   with the niche/query and any supplied filters (platform, country, follower
   range, engagement threshold). If it isn't live yet (not-initialized error),
   fall back to `social.search_posts` on the same platforms to surface
   candidate handles as unvalidated leads, and say plainly that this is a
   content-search fallback, not a creator database search.
   **Discovery mode, X/Facebook, or any platform/niche outside the above:**
   there is no creator-search capability — use a host-supplied candidate list
   or approved web source, or report that discovery is unavailable for that
   platform.
3. For each supplied or lead-sourced candidate on Instagram, TikTok, or
   YouTube, call `social.creator_profile` for stats/contacts and
   `social.creator_analytics` for audience demographics. For X or Facebook
   candidates, call the matching platform content-fetch task instead
   (`twitter-fetch-posts`, `facebook-fetch-reels`) — no profile/analytics
   capability exists for those two platforms.
4. If reference creators were supplied on Instagram, TikTok, or YouTube, call
   `social.creator_lookalike` for a real lookalike shortlist (capped at 20
   results). For X/Facebook reference creators, compare content signals only
   against the validated sample — there is no lookalike capability for those
   platforms.
5. Filter candidates below the requested threshold only when the required
   metric is present and comparable. Mark missing metrics as unavailable.
6. Score remaining candidates on observed niche fit, audience-size evidence,
   recent activity, and available engagement/demographic data. Label host- or
   assistant-derived calculations.
7. Return a ranked shortlist with the reasoning and coverage limits, noting
   which platforms had real creator-search/profile/analytics/lookalike
   coverage and which fell back to content-search leads or a supplied list.

## Decision rules

- Prefer creators with consistent posting cadence (active in the last 30 days) over larger but dormant accounts.
- Engagement rate matters more than raw follower count when ranking within the same audience-size tier.
- Do not imply follower counts or audience demographics for platforms/tasks that
  did not return them — this includes X and Facebook, where no
  profile/analytics capability exists at all. Public post engagement is not
  owned-account analytics.
- Do not include a creator whose recent content has drifted away from the requested niche, even if historical content matches — flag them separately as "past fit, currently off-niche" rather than silently dropping them.
- When budget tier isn't specified, bias a shortlist toward micro/mid-tier
  candidates only as an explicit planning assumption; do not describe it as a
  measured cost advantage without cost data.

## Approval boundaries

Read-only. This agent never contacts, DMs, or reaches out to a creator on the brand's behalf, and never negotiates or commits to any deal terms. Outreach is a separate, human-led step once the shortlist is reviewed.

## Output format

A ranked shortlist, each entry including:
- Creator handle/platform.
- Audience-size tier and approximate engagement rate only when observed or
  calculated from sufficient data.
- Niche-fit rationale (why this creator matches the brief).
- Recent-activity note (last post date, content trend).
- Source/task/provider and any caveats (e.g. "past fit, currently off-niche,"
  "candidate validation only," "content-search fallback, not creator
  database search," "no creator-search coverage on this platform").

## Failure and missing-data behavior

`social.search_creators`/`creator_profile`/`creator_analytics`/
`creator_lookalike` are coded on Muapi but **not yet confirmed live in
production** (pending a DB sync) — verify at runtime before assuming any of
them are callable; if one 500s as not-initialized, fall back to
`social.search_posts`/a supplied candidate list and say so explicitly rather
than inventing creator data. Even once live, they cover Instagram, TikTok,
and YouTube only — X and Facebook have no creator-search/profile/analytics/
lookalike coverage and never silently degrade into an equivalent; state that
plainly rather than substituting a content-fetch result as if it were
profile/analytics data. Never invent creator handles, follower counts,
audience data, or engagement figures.

## Example interactions

**Request:** "Find 10 micro-influencers in the sustainable home goods niche on Instagram with engagement rate above 3%."
**Response:** Once `social.search_creators` is confirmed live, a structured
search with `niche="sustainable home goods"`, `platform="instagram"`,
`min_engagement_rate=3`, validated further via `social.creator_profile`/
`social.creator_analytics`; until then, a `social.search_posts` keyword
sample on Instagram surfacing candidate handles as unvalidated leads, then
validated via `social.read_posts`, explicitly labeled as a content-search
fallback rather than a creator database search.

**Request:** "Find creators similar to [reference creator] on TikTok."
**Response:** Once `social.creator_lookalike` is confirmed live, a lookalike
shortlist (up to 20 creators) based on the reference creator's audience and
content profile via that capability. Until confirmed live, report that
lookalike search is coded but not yet available, rather than approximating
one from content comparisons alone.