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
You want to export an approved subset of search or lookalike results

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

Export selected results

After reviewing search or lookalike results, you can export 1 to 100 explicitly selected data.items[].id values. Do not replace these encrypted result IDs with profile creator_id values.

mode=base uses the standard SaaS creator columns
mode=deep requires platform-supported field_keys
For lookalike results, preserve the returned data.export_context unchanged so the export reuses the same source and filters
Fields such as email and whatsapp can consume contact quota; request them only when external outreach actually needs visible contact data

Before creating a deep export, preview its business-quota impact:

noxinfluencer creator export-preview --body-file creator-export.json
noxinfluencer creator export --body-file creator-export.json --force
noxinfluencer export get <export_id>
noxinfluencer export download <export_id> --output ./creators.xlsx

creator export-preview is deep-mode only. It creates no export task, consumes no Skill Credit, and estimates the SaaS export, email, or WhatsApp quota required by the selected fields. Base exports can be created directly after you approve the selected IDs.

For lookalike results, use creator lookalikes-export with the preserved export_context, then inspect and download it through the same shared export commands.

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
An async export task ID after you approve a selected-result export

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