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
Query mode: use --keywords for topic discovery, or --creator_name when you already know a creator name or handle
Creator size range
Whether commercial fit or contactability should matter
Use --has_email true when platform email outreach needs creators with an email signal; this does not mean visible email has already been exported

Query modes

Use --keywords when you are exploring a topic, category, or niche
Use --creator_name when you are looking for a known creator name or handle
Do not combine --keywords and --creator_name in the same search
Use --keyword_match all only when every supplied keyword must match; the default behavior is broader any-keyword matching

noxinfluencer creator search --platform youtube --creator_name "MrBeast" --page_size 5
noxinfluencer creator search --platform tiktok --keywords '[coffee,review]' --keyword_match all

Pagination and result shape

The CLI defaults to page_size=20 and supports up to --page_size 100
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

Pricing and usage planning

Creator search and lookalike discovery are currently priced by returned creator count, not by a fixed page request. Before a broad shortlist expansion, check current prices and recent usage:

noxinfluencer pricing tools --action creator_search
noxinfluencer pricing tools --action creator_lookalikes
noxinfluencer quota usage --days 7 --tool discover_creators

Use smaller, purposeful pages for exploration. Increase page_size only when the filters are already specific enough and you actually need a larger shortlist.

Hide and deduplicate a returned page

After a search page is returned, you can apply SaaS-aligned hide and deduplication rules to that current page.

Use this when you want to hide candidates that are already completed collaborations, under collaboration, in communication, contacted by your account or team, or already in a selected collection.

noxinfluencer creator search-filter-options
noxinfluencer creator search-filter --body-file search-filter.json

creator search-filter filters the current page of data.items[].id values. It does not launch a new creator search, and it should not be used as a replacement for normal search filters such as platform, keyword, country, or follower range.

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
Optional filtered rows after applying hide or deduplication rules to the current page

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
NoxInfluencer platform email tasks can use creator search/profile creator_id values directly; visible contact retrieval is only needed for external outreach

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