Pay for API calls without a subscription
By Starcovery. Updated .
How Starcovery credits work: the organization ledger and prepaid packs bought with Stripe Checkout.
This page covers how organizations buy and spend credits.
Credits live on the organization credit ledger. Humans and agents that act inside the same organization spend the same prepaid credits. A credit costs $0.05 and buys one identified search past the daily grant or one paid product action, as the cost table below lists. There are no seats and no subscriptions.
Every account is guaranteed at least one organization on first sign-in. Organization settings shows the active organization's name, members, roles, and invitations. Solo users manage organization-scoped billing and credentials there. To switch the active organization, use the Organizations menu in the app sidebar.
Owners and admins buy prepaid credit packs through Stripe Checkout. Any member spends credits on search, contact reveal, and campaigns. Members without an owner or admin role cannot buy prepaid credits; Starcovery rejects the request before calling Stripe.
Read the balance and identified daily search grant status:
curl "https://www.starcovery.com/api/billing/state" \
-H "x-api-key: <access_token>"The response includes prepaid balance, dailySearches (limit, remaining, resetAt), and freeGrant.
Search spend
A search through the API is one use, and a thread turn on the web, over MCP thread_turn, or with starcovery threads runThreadTurn is one use plus one for each new search and each exclusion it runs, so a new search typed on the website is two. An outside agent that calls search, List, and campaign tools directly pays only for the searches and other charged operations it runs.
Unsigned callers get 100 uses per UTC day per IP. When the unsigned grant is used, unsigned search returns 402 and a thread turn streams only its out-of-allowance part.
Identified callers get 200 uses per UTC day per user, and the members of one organization share at most 200 between them. Uses past either limit spend prepaid credits, one credit each. When prepaid credits are empty, identified search returns 402.
A repeat of a brief and filters spends no grant and no credit when the organization already searched them and that search is still in its search history, or, for an unsigned caller, within 24 hours of the first search of them from the same IP.
What each action costs
| Action | Cost |
|---|---|
| Search within the daily grant | Free |
| Search past the daily grant | 1 credit |
| Repeat search, while the first search is in search history (24 hours unsigned) | Free |
| Search thread turn | 1 use for the turn, from the daily grant and then 1 credit, plus up to 3 searches and exclusions in all, each billed like a search |
| Campaign generate | One search, billed like a search |
| Shortlist enrichment | Free, with the ticket from a search |
| Contact reveal | 5 credits the first time the organization reveals a profile |
| Private campaign | 1 credit at creation, or when a public campaign becomes private |
Reveal contact
Creator contact addresses stay hidden until this organization reveals them. POST /api/creators/{profileId}/contact spends 5 prepaid credits the first time that organization reveals that profile. Later reveals return the address without charging. Search, API, MCP, CLI, and the profile UI omit the address until then.
When the prepaid balance holds fewer than 5 credits, contact reveal returns 402 out_of_credits. Buy a pack in Billing settings, then retry.
Prepaid packs (humans)
Humans buy packs with Stripe Checkout at Billing settings. Larger packs include bonus credits at the same list rate. Current ladder and bonuses: pricing.
When credits run out
A charged request returns 402 out_of_credits when the organization has no prepaid credits left. The body links to the packs in packsUrl:
{
"authUrl": "https://www.starcovery.com/agents",
"error": "out_of_credits",
"freeGrant": "identified_daily",
"packsUrl": "https://www.starcovery.com/app?settings=billing"
}An owner or admin buys a pack there, then the request can run again. The CLI prints this body on stderr and exits 1.