Discover Creators

Current status: Available

Discover Creators helps you find candidate creators and build a shortlist worth reviewing next. It is the sourcing step, not the place to finish creator due diligence.

Best-fit use cases

  • You already know the target platform, market, or category
  • You want a shortlist before deep due diligence
  • You need a clean handoff into creator analysis

Recommended inputs

  • Platform
  • Market or country
  • Category, keywords, or content direction
  • Creator size range
  • Whether commercial fit or contactability should matter

Pagination and result shape

  • The CLI defaults to page_size=10 and supports up to --page_size 20
  • For deeper pagination, reuse the prior response's data.search_after
  • Prefer a JSON body through --body-file - when passing cursor arrays or complex filters
  • Search rows expose search-result identifiers for follow-up, but full identity comes from a later creator read

Typical output

  • A list of candidate creators
  • Basic fit signals such as platform, audience size, market, or topical match
  • Search result identifiers that help you decide who to inspect next

What discovery output does not include yet

  • Discovery results are not the same as a full creator read
  • Do not assume the search result already contains the unified creator identity block: creator_id, creator_name, channel_handle, channel_url, and social_media
  • When you need a stable identity for follow-up steps, move into creator analysis or another creator read and then reuse the returned creator_id

What it is not for

  • It does not replace deep evaluation
  • It does not mean a creator is ready for outreach
  • It should not be treated as a final collaboration list

Recommended next steps