Skip to main content
Create an API key in the developer dashboard, then run these commands in a terminal with curl. The search requests five creators and costs up to $0.35.

Set your key

Keep the key server-side and out of version control.

Search for five creators

The response contains 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.
This illustrates fields, rather than output from a real account. The Search reference contains the full schema.
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 or curl and jq. Each example retrieves a creator using an ID from your search response.
Install the SDK and a TypeScript runner in your project:
Save this as quickstart.ts:
quickstart.ts
Run it:
Use your project’s package manager if it differs. SDK setup includes npm, Yarn, and Bun commands.

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.