Skip to main content
Every standard API request costs 1 credit, per page of results rather than per result. No multipliers, no hidden costs. Batch endpoints bill 1 credit per ID submitted (10 IDs = 10 credits). New accounts get 100 free credits on sign-up, no credit card required. Credits are prepaid, so you are never billed for usage after the fact.

Tracking usage

Every authenticated response includes two headers:

Plans

Choose the Mini plan to start without paying: pay as you go, with no subscription and no credit card, using your 100 free sign-up credits. It is the best way to evaluate KonbiniAPI, build prototypes, and run personal projects. When you need more volume at a lower rate, choose a monthly plan. See konbiniapi.com/pricing for the full comparison. On the Mini plan, credits expire 12 months after your last purchase. On monthly plans, plan credits reset every billing cycle and do not roll over.

Plan credits and extra credits

Accounts on a monthly plan can have two kinds of credits:
  • Plan credits come with your subscription. They reset each billing cycle when your subscription renews, and unused plan credits do not roll over.
  • Extra credits are bought separately in $20 bundles. They are available to any account, including Mini, and stay in your account until they expire.
Plan credits are always used first. Extra credits are only used once your plan credits are gone.

Buying extra credits

Buy extra credits from the billing page in the dashboard. A bundle always costs $20, and what it contains depends on your plan: Subscribers buy at their plan’s rate, up to 2x their monthly plan credits per billing period (Plus 50,000, Pro 110,000, Max 320,000; Ultra has no limit). Beyond that, extra credits are priced at the Mini rate of 5,000 per bundle.

Expiry

Extra credits last 12 months after your last purchase; buying again extends the date for your whole extra credit balance. They remain in your account if you cancel your subscription. Plan credits expire at the end of each billing cycle.

When credits run out

If your account has no credits left, requests return a 402 status with the error code credits_exhausted. To keep going, you can:
  • buy extra credits in $20 bundles, which are available immediately,
  • upgrade to a monthly plan with more credits, or
  • wait for your plan to renew, if you are on a monthly plan.
There are no overage charges. Your account is never billed beyond the credits you bought.

Failed renewals

If a renewal payment fails, your plan credits are paused until the payment succeeds. Extra credits keep working in the meantime. Update your card in the dashboard and the payment is retried immediately.

Cancelling

Cancelling a subscription stops renewal. Your plan credits stay usable until the end of the current billing period, then the account moves to the Mini plan. Any extra credits you hold remain until they expire.

Refunds

Requests that fail due to validation errors, server errors, timeouts, or upstream platform issues do not consume credits:

Rate limits

There are no per-second or per-minute rate limits. You can make concurrent requests freely. The only limit is your credit balance: when credits reach zero, requests return 402.