Pricing

This page is the plan and credit reference for the kwery API. If you're new to the account lifecycle — signing up, checking usage, running out — read Self-serve first.

Every plan grants a fixed number of included credits each month. Paid Growth plans keep running past the included amount at the overage rate; the free plan stops. Upgrades and downgrades are managed in the dashboard and take effect immediately.

Credits are consumed per successful result. Every source costs 1 credit, except kaufland (3 credits), which has a higher delivery cost:

What counts, and what doesn't:

• Every successful result is billed — including a re-query of a product you've looked up before. Freshness parameters (max_age) control how recent the data is, not what it costs.
• "Not found" answers are free — whether freshly determined or served from the not-found cache.
• Failed lookups are free — blocked, timed-out, and lost results are never billed.

Credits are debited once per job, at completion, across the batch of values in that job. Weights are per source and may change if a source's delivery cost structurally changes — any change is announced in advance and never applies retroactively to a running period.

• Unused credits automatically roll over. Included credits you don't use in a billing period stay on your balance — they are not forfeited at the period boundary.
• Purchased credits never expire.

Your billing period renews on the first of each month at 00:00 UTC — the period_resets_at field in the credits response gives the exact next boundary. Overage counters (overage_units_this_period, overage_amount_cents) start fresh each period.

When a Growth plan (growth-s / growth-m / growth-l) exhausts its credit balance, it does not stop. You continue seamlessly into overage, billed per 1 000 credits at your plan's overage rate (see Plans). The credits response tells you exactly what you've accrued:

{
  "included": 100000,
  "used": 112400,
  "balance": 0,
  "plan": "growth-s",
  "plan_kind": "paid",
  "period_resets_at": "2026-09-01T00:00:00.000Z",
  "overage_units_this_period": 12400,
  "overage_amount_cents": 4948,
  "budget_cap_cents": null,
  "budget_cap_reached": false
}

The free plan behaves differently: it has no overage. Once balance reaches 0, job submission returns HTTP 402:

{ "error": true, "message": "out of credits" }

Nothing is charged beyond the included 1 000 — you resume at the next monthly renewal or by upgrading.

To stop a Growth plan from accruing unbounded overage, set a budget cap:

curl -s -X PATCH https://api.kwery.co/v1/account/budget-cap \
  -H "Authorization: Bearer $DASHBOARD_SESSION_JWT" \
  -H "Content-Type: application/json" \
  -d '{ "cap_cents": 5000, "action": "hard_stop" }'

• action: "hard_stop" — job submission returns 402 once accrued overage cost reaches cap_cents for the period.
• action: "notify" — you're alerted at the cap but never blocked; overage continues.

enterprise is a custom annual contract with an agreed volume — millions of SKUs per month — on the same source-weighted credit model described above. There is no hard cap: usage is invoiced against the agreed volume at the end of each period. Enterprise adds custom source onboarding (new markets, new sources), a dedicated account manager, and audit-trail export for compliance. Contact sales to set one up.

• Self-serve — the account lifecycle: signup, credits, running out, plans.
• Getting started — submit your first job.
• Trust — the confidence score on every result.