search_creators
Search creators
Search Kolect's database of TikTok, Instagram and YouTube creators. Give a plain-language brief (any language: market, niche, follower range, content style, audience...), or similar_to (a profile link, @handle or creator id) to find lookalike creators, or both. Costs the user's credits: 1 credit per 2 creators returned (count 20 = 10 credits); no results cost nothing. Calling again with the same arguments within 15 minutes returns the same results without charging. Results include each creator's id: use it with check_fake_followers, get_emails and save_creators, and the search_id with load_more_results and get_search_results. Values under ai_estimate are AI estimates; say so when you present them.
輸入參數briefcountplatform必填similar_to
load_more_results
Load more results
Get more new creators for one of the user's earlier searches. Costs 1 credit per 2 new creators returned. Calling again right away with the same arguments returns the same page without charging.
輸入參數countsearch_id必填
get_search_results
Read earlier search results
Read creators already delivered by one of the user's earlier searches (free). Use next_cursor to page through them. To get new creators beyond those already delivered, use load_more_results.
輸入參數limitcursorsearch_id必填
lookup_creators
Look up creators by link or handle
Check whether specific creators are in Kolect's database, by profile link or @handle, and get their creator ids (needed for check_fake_followers, get_emails and save_creators). Free. Limits per call and per day depend on the user's plan (no subscription: 10 per call, 200 a day; Light: 30 and 500; Plus and above: 100 and 3,000); the daily limit counts only creators found for the first time, and creators past it come back in skipped as over_daily_limit. Bare @handles need platform. Supports TikTok, Instagram and YouTube only.
輸入參數creators必填platform
check_fake_followers
Check fake followers
Estimate how real up to 20 creators' followers are, from public views, engagement, likes and following. Creator ids must come from this user's searches (pass search_id), lookups or saved creators. The first checks each day are free (see get_account), then 5 credits each; creators without enough data cost nothing; results from the last 7 days are reused for free unless fresh=true. This is a rule-based estimate, not platform data; present it that way.
輸入參數freshsearch_idcreator_ids必填
get_emails
Get contact emails
Get public contact emails for up to 20 creators. Free for creators from this user's search results (pass search_id; the search already paid for them) and for ones unlocked before. Creators found by lookup_creators need an unlock: free for paid subscribers during the current promotion (daily cap), otherwise 5 credits per email found; no email, no charge. Only show emails to this user; never publish them.
輸入參數search_idcreator_ids必填
save_creators
Save creators
Save creators to the user's Kolect favorites, optionally into a collection (an existing collection's name or id; a new name creates it). Free. Creator ids must come from this user's searches (pass search_id), lookups or saved creators. Saved creators appear on the Kolect website, where the user can export them as CSV. Pass quotes to record the rate the user actually got from a creator (shown only to this user as 'my quote').
輸入參數quotessearch_idcollectioncreator_ids必填
list_saved_creators
List saved creators
List the user's saved creators (all, or one collection by name or id) with current follower and view numbers, plus the user's collections. Free. Good for building a shortlist, a report or a spreadsheet.
輸入參數limitcollection
get_account
Account and credits
The user's Kolect plan, credit balance, today's free fake-follower checks and email unlocks, lookup limits, this key's daily credit limit, and their collections. Free. Check it before a large paid step.
無需輸入參數。