Working with it
Credits
What a call costs, before and after.
Every plan is a monthly allowance of credits, shared across every tool. A credit is a page. Most pages cost one.
The rate card
| Unit | Credits | When it applies |
|---|---|---|
| Direct fetch | 1 / request | A page that answered a plain request. Most pages do. |
| Proxied fetch | 2 / request | A page that would not answer until the request came from somewhere else. |
| Browser fetch | 5 / request | A page that had to be rendered in a real browser before it made any sense. |
| PDF parsing | 1 / page | Per page parsed, added to the fetch cost. |
| Cache hit, your own page | 0 / request | A page you already fetched, re-read within maxAge. Never charged twice. |
| Cache hit, already indexed | 1 / request | A page someone had already fetched, served instantly from the index. |
| Web search | 2 / request | Per search call. Result pages fetched are metered as scrapes on top. |
| Site map | 1 / request | Per map call, however many URLs come back. |
| Catalogue or feed page | 1 / page | Up to 250 products, or 100 posts, in a single call. |
| Domain lookup | 1 / request | Registration, DNS and known backlinks for one domain. |
| Company enrichment | 3 / request | Firmographics, contact emails, LinkedIn and socials for one company, from its own site. |
| Places search | 5 / request | One search for business listings, however many come back. |
| Place detail | 2 / place | Website, phone and contacts for one business. Only when you ask for them. |
| A request that failed | 0 / request | Nothing came back, so nothing is charged. |
Reading the cost
Every response carries a cost object. It says what was charged and why, so you can measure a job before you scale it rather than discovering the bill afterwards:
"cost": { "credits": 1, "cached": false}
The same numbers appear in your activity log, per call, with the URL beside them.
Reducing spend
- Let the cache work. A page fetched again within
maxAgeis free. The default window is generous; widen it for content that rarely moves. - Map before you crawl. Map lists a site's URLs for 1 credit, so you can crawl only the section you want.
- Ask the platform. Products and Posts read a store's or blog's own listing API — hundreds of records for a single credit, instead of a page each.
- Give Extract a schema, not a prompt. Extract reads a page's own structured markup first, so a fixed schema usually costs nothing beyond the page itself.
Out of credits? Requests return
402 with the reason. Nothing is charged — see Pricing.