Home / Docs / Credits and billing

Credits and billing

A site in a list costs one credit and a domain lookup costs two. Counts, technology search, balance checks, checkout links and "not covered" lookups are free.

Plans and top-ups

Plan detailStarterGrowth RecommendedProScale
Price$49 /mo$149 /mo$399 /mo$999 /mo
Credits each month15,00060,000200,000750,000
item valuestartergrowthproscale

Top-ups are $15 per 1,000 credits, up to 100 blocks in one checkout, and last 12 months. You can buy them on any plan or with no plan at all.

Monthly reset and spend order

Plan credits arrive when each monthly invoice is paid and don't roll over: whatever's left goes when the next month's credits land. Spending takes plan credits first, then top-up credits, then the free grant. If you cancel a plan, the credits you already have last until the end of that billing month.

Plans are changed or cancelled from the billing link on your account page, which opens Stripe's billing portal with your invoices and payment details.

When credits run out

A call is charged after it runs, for what it actually returned, and meta.credits_remaining shows the balance afterwards. When a paid call can't be covered, it fails with HTTP 402 and the code insufficient_credits, and nothing is charged. The error says how many credits the call needed, how many were available, how many it was short, and why, in reason:

reasonWhat it meansWhat to do
balanceThe account is out of credits.Open one of the checkout links in options: a top-up that covers the shortfall, or the smallest plan that covers the call. Links last 7 days.
max_creditsThe call's max_credits is lower than its cost.Raise max_credits or narrow the request.
key_capThis key or connected app has reached its monthly cap.The account owner can raise the cap on the account page.
{
  "error": {
    "code": "insufficient_credits",
    "message": "This call costs ... credits and the balance is .... ...",
    "credits_needed": ...,
    "credits_available": ...,
    "credits_short": ...,
    "reason": "balance",
    "options": [
      { "item": "topup", "units": ..., "label": "...", "price": "...", "checkout_url": "https://.../buy/..." },
      { "item": "...", "label": "...", "price": ".../month", "checkout_url": "https://.../buy/..." }
    ],
    "next_step": "A human opens a checkout_url and pays; the credits appear on the next get_balance."
  }
}