Discovery
Find new creators for a topic, or look up creators you already know.
Use search_creators for known handles or names (free), and discover_creators for new creators on a topic (20 credits). A discovery returns a job_id: wait for it with wait_for_job, then read it with get_discovery.
search_creators
search_creatorsread-onlyLook up creators by handle or name across Instagram and YouTube (free, 60 per hour). For finding NEW creators by topic use discover_creators.
| Parameter | Type | Default | Limits |
|---|---|---|---|
queryrequired | string | | 2–200 chars |
limit | integer | 5 | 1–10 |
get_creator
get_creatorread-onlyCreator profile with audience demographics (age, gender, geo) where the creator connected their account. creator_id: Instagram handle or sigment_creator_id; YouTube/TikTok: the `id` from search.
| Parameter | Type | Default | Limits |
|---|---|---|---|
platformrequired | "instagram" | "youtube" | "tiktok" | | |
creator_idrequired | string | | 1–100 chars |
discover_creators
discover_creatorsasks before runningFind new creators for a topic (e.g. 'vegan fitness moms'). Costs 20 credits (free if the same topic ran in the last 24h). Returns a job_id: wait_for_job, then get_discovery.
| Parameter | Type | Default | Limits |
|---|---|---|---|
topicrequired | string | | 2–200 chars |
max_creditsrequired | integer | | 0–1000 |
platforms | ("instagram" | "youtube" | "tiktok")[] | ["instagram"] | 1–3 items |
min_followers | integer | 2000 | ≥ 0 |
per_subtopic_limit | integer | 10 | 1–20 |
workspace_id | string | | 1–100 chars |
list_discoveries
list_discoveriesread-onlyPast discovery searches (newest first) — resume earlier work from here.
| Parameter | Type | Default | Limits |
|---|---|---|---|
limit | integer | 10 | 1–50 |
get_discovery
get_discoveryread-onlyCreators found by a discovery, grouped by subtopic, plus the strongest audience overlaps. Pass `handles` to get the overlaps involving those creators instead of the global top 15. For the full interest graph of a creator set, analyze_creators it and read get_analysis_result.interest_graph.
| Parameter | Type | Default | Limits |
|---|---|---|---|
discovery_idrequired | string | | 1–100 chars |
max_per_group | integer | 10 | 1–20 |
handles | string[] | | ≤ 50 items |