curl. The search requests five creators and costs up to $0.35.
Set your key
Search for five creators
data: a list of creators, their Instagram profiles, and match reasons. Read data[].creator.id to retrieve a creator, or data[].match.reasons to explain a result in your interface. A search can return fewer than five creators, including none.
See an abbreviated, fictional search response
See an abbreviated, fictional search response
quality.mode and match.ranking_source distinguish AI-reranked results from retrieval fallback. A score is a ranking signal, not a percentage guarantee. See search quality.
The POST already returns its visible results. Saved search reads reread them for free; they do not discover additional creators.
Search and retrieve a creator
For the complete workflow, use Node.js 22+ with TypeScript orcurl and jq. Each example retrieves a creator using an ID from your search response.
Run the complete TypeScript or cURL example
Run the complete TypeScript or cURL example
- TypeScript
- cURL
Install the SDK and a TypeScript runner in your project:Save this as Run it:Use your project’s package manager if it differs. SDK setup includes npm, Yarn, and Bun commands.
quickstart.ts:quickstart.ts
Costs and failures
New API customers receive 500 starter credits, with no card required. Search costs 25 credits plus 2 per creator delivered. Fetching one creator costs 0.1 credits. With five search results, the complete example costs 35.1 credits ($0.351). Fewer results reduce that cost; an empty search still incurs its 25-credit base fee.X-Credits-Charged reports the cost of a successful request. RateLimit-Remaining-* reports request-speed budgets, not your starter-credit balance. See Pricing for the difference.
Build your workflow
Score known handles
Resolve an existing list and evaluate campaign fit.
Build and save a shortlist
Review candidates, expand profiles, and keep selected creators.
Fetch live platform data
Start from an Instagram, TikTok, or YouTube resource.
Build a creator research app
Search, review evidence, and save selections in a complete interface.
Choose an app or workflow
Run the Next.js starter or a complete campaign research script.