Quickstart

Search before signing up

Search takes a plain-language brief. No credential is needed for the first call.

curl "https://www.starcovery.com/api/search?q=slow+morning+coffee"

npx starcovery search "slow morning coffee"

Unsigned search is free for 50 calls per UTC day per IP, plus a small per-minute burst. When you hit the cap, the API answers 429 with an authUrl that points at registration.

Narrow the shortlist

The q parameter carries the brief. Three optional filters narrow it:

Filter	Values
`platform`	`ig`, `tt`
`tier`	`nano` 1K-10K, `micro` 10K-50K, `mid` 50K-250K, `macro` 250K-1M, `mega` 1M+ followers
`country`	`au`, `br`, `ca`, `de`, `fr`, `gb`, `in`, `jp`, `kr`, `us`

curl "https://www.starcovery.com/api/search?q=slow+morning+coffee&platform=ig&tier=nano&country=us"

Anything else answers 400 with the issues named. Full details: Search.

Register an identity

Registration is self-serve for agents and humans alike. The short path is the CLI:

npx starcovery auth register

This follows the auth.md protocol, exchanges a service-signed assertion for an access token, and saves the credential to ~/.config/starcovery/config.json. The same protocol works over plain HTTP. See Authentication. Send the token as Authorization: Bearer <access_token> or as x-api-key on every API call.

Start a campaign

Campaigns turn a goal into a managed shortlist: create with a goal, generate matches, then augment and operate.

curl -X POST "https://www.starcovery.com/api/campaigns" \
  -H "x-api-key: <access_token>" \
  -H "content-type: application/json" \
  -d '{"name": "Coffee", "goal": "quiet morning coffee creators who film at home"}'

See Campaigns and the API reference.

Next steps

Authentication

The full agentic signup protocol, claim ceremony, and token exchange.

Connect over MCP

One URL turns Starcovery into a tool your agent can call.

Credits and payments

Free grants, prepaid packs, and machine payments.

CLI

Search, campaigns, credits, and keys from your terminal.

Get started

Guides

Search before signing up

Narrow the shortlist

Register an identity

Start a campaign

Next steps

Authentication

Connect over MCP

Credits and payments

CLI

​Search before signing up

​Narrow the shortlist

​Register an identity

​Start a campaign

​Next steps

Authentication

Connect over MCP

Credits and payments

CLI

Search before signing up

Narrow the shortlist

Register an identity

Start a campaign

Next steps