{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Self-serve","description":"Real-time price and offer data across major marketplaces."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"self-serve","__idx":0},"children":["Self-serve"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["kwery's self-serve tier lets you sign up, start crawling, and pay as you go — no manual"," ","provisioning required. This guide covers the account lifecycle: signing up, how credits are"," ","consumed, watching your usage, and what happens when you run out. The full plan and rate"," ","tables live on one page only: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing"},"children":["Pricing"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Self-serve accounts authenticate the data API with an API key and the dashboard with a"," ","separate session — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["Authentication"]}," if you haven't already."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-sign-up","__idx":1},"children":["1. Sign up"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create an account at ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://kwery.co"},"children":["kwery.co"]},". Signup provisions your org"," ","automatically and grants ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["1 000 free credits per month"]}," — enough to try every source"," ","before you commit to a plan. Your first API key is issued right away in the dashboard."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-how-credits-work","__idx":2},"children":["2. How credits work"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["successful"]}," result consumes credits at the per-source weight — see the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#source-weights"},"children":["credit weights by source"]}," table. That includes re-queries of"," ","products you've looked up before. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Not found\" answers and failed lookups cost zero"," ","credits."]}," Unused credits ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#rollover"},"children":["roll over"]},", and purchased credits never expire."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits are debited once per job, at completion, for the batch of values in that job."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cached-re-serves-and-freshness","__idx":3},"children":["Cached re-serves and freshness"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["kwery caches recent data per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["key:value"]}," and reuses it where it can to answer faster. Two"," ","per-job parameters control how fresh your answers must be:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_age"]}," (seconds, default 1200) — cached data younger than this may be used to assemble"," ","the answer instead of re-fetching everything."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_found_max_age"]}," (days, default 10) — how long a cached \"not found\" answer is honoured"," ","before we re-check."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Freshness controls recency, not billing."]}," A successful result costs its per-source"," ","credits whether it was assembled with the help of cached data or crawled entirely fresh;"," ","\"not found\" answers are free either way. Narrow the windows when you need up-to-the-minute"," ","data; widen them when speed matters more than recency."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-check-your-usage","__idx":4},"children":["3. Check your usage"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -s https://api.kwery.co/v1/account/credits \\\n  -H \"Authorization: Bearer $DASHBOARD_SESSION_JWT\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"included\": 1000,\n  \"used\": 640,\n  \"balance\": 360,\n  \"percent_used\": 64,\n  \"status\": \"ok\",\n  \"period_resets_at\": \"2026-08-01T00:00:00.000Z\",\n  \"plan\": \"free\",\n  \"plan_kind\": \"free\",\n  \"enforcement_mode\": \"hard_stop\",\n  \"overage_units_this_period\": 0,\n  \"overage_amount_cents\": 0,\n  \"budget_cap_cents\": null,\n  \"budget_cap_reached\": false\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," moves through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ok"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warning"]}," (≥80% used) → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["critical"]}," (≥95%) → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["depleted"]}," ","(balance 0). We email you at each threshold so you're not surprised by a 402."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint uses your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["dashboard session"]},", not your API key — see"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication#which-auth-do-i-use"},"children":["Authentication"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-running-out-of-credits","__idx":5},"children":["4. Running out of credits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["What happens at zero balance depends on your plan:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Free tier"]}," — hard-stops with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HTTP 402"]}," on new job submission until the next monthly"," ","renewal (or an upgrade). Nothing is ever charged."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Growth plans"]}," — continue seamlessly into ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#overage"},"children":["overage"]},", billed at your"," ","plan's rate. To stop instead of accruing overage, set a"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#budget-cap"},"children":["budget cap"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"5-plans","__idx":6},"children":["5. Plans"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Plan tiers, prices, included credits, and overage rates are listed once, on"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#plans"},"children":["Pricing → Plans"]},". Upgrades, downgrades, and billing are managed in the"," ","dashboard; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["enterprise"]}," is a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing#enterprise"},"children":["custom annual contract"]}," — contact us to"," ","set one up."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":7},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/authentication"},"children":["Authentication"]}," — API key vs dashboard session, and when to use each."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/getting-started"},"children":["Getting started"]}," — submit your first job."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/pricing"},"children":["Pricing"]}," — plans, credit weights, overage, and rollover."]}]}]},"headings":[{"value":"Self-serve","id":"self-serve","depth":1},{"value":"1. Sign up","id":"1-sign-up","depth":2},{"value":"2. How credits work","id":"2-how-credits-work","depth":2},{"value":"Cached re-serves and freshness","id":"cached-re-serves-and-freshness","depth":3},{"value":"3. Check your usage","id":"3-check-your-usage","depth":2},{"value":"4. Running out of credits","id":"4-running-out-of-credits","depth":2},{"value":"5. Plans","id":"5-plans","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Self-serve"}},"lastModified":"2026-08-28T10:47:09.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/self-serve","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}