Credits and billing

Credits pay for pages fetched

Extraction Jobs are paid in credits from your account wallet, never charged directly to a card. Each endpoint has a price per page fetched. By default that is 5 credits per search page and 1 credit per product page. Rows, products and variants are output measures, not billing units.

Your agent sees each endpoint's current price in list_job_blueprints before it submits a Job. Some endpoints, such as newly qualified sites, can have a different price or none yet; the listed price is the one that applies.

Holds and settlement

When a Job is submitted, the credits for the pages it asks for (max_pages, up to the endpoint's limit; 1 page by default) are set aside. When the Job finishes it pays only for pages fetched successfully, and the rest of the hold is released. Asking for 10 pages and fetching 5 costs 5 pages.

The price is fixed when the Job is submitted. A later price change does not affect a Job that is already running.

Failed and empty Jobs are free

A Job that fails or returns nothing costs no credits; its hold is released. Repeating a submission with the same idempotency key returns the same Job and is not charged again.

Trial credits and low balance

Every account starts with 200 free trial credits. When your balance cannot cover a new Job's hold, the Job is refused with insufficient_credits (HTTP 402). Ask for fewer pages to lower the hold.

Buy more credits on the dashboard under Billing: Scout $10 for 10,000 credits, Agent $25 for 26,250, Fleet $100 for 110,000 and Swarm $600 for 708,000. You pay on Stripe's checkout page and the credits are added once the payment is confirmed. Product search and seller offers through MCP do not use credits; they are free within a daily allowance per account.

Earlier store extraction API

The earlier credit-based store extraction API (/api/product/runs) is not accepting requests. Its page budgets and one-credit-per-page rules do not apply to extraction Jobs. Historical runs keep their settled charges. Contact support with a run or Job ID to investigate a charge.