Skip to main content
POST
Estimate the price of reading web pages
Estimate the cost of reading web pages before running the request. Send the same body you would send to Web Contents — it is validated the same way. Nothing is charged.
Unlike the other /price endpoints, this one returns the price at the top level — {"price": 0.0012} — not inside data.
The quote assumes every URL can be read. Pages that come back as not_found or unknown are not charged, so the actual cost can be lower than the quote, never higher.

Authorizations

Authorization
string
header
required

Sanctum personal access token, sent as Authorization: Bearer <token>. The token is opaque — it carries no claims and no embedded expiry, so do not attempt to decode it. Issue and revoke tokens from your account dashboard.

Headers

Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

application/json

Request at least one of text, excerpts or summary — a request with none of them is refused with 422.

urls
string<uri>[]
required

Pages to read. Full URLs including the scheme (https://…).

Required array length: 1 - 20 elements
Example:
text

Return the page as clean text (Markdown-like). true uses the default length cap of 20,000 characters; an object lets you set your own cap. Longer pages are cut at the cap.

Example:
excerpts

Return the passages of the page most relevant to your search (or to query, if you set one). true ranks passages against the search query; on the contents endpoint, which has no search query, pass an object with query to steer the selection.

Example:

true

summary

Return a short AI-written summary of each page. true writes a general summary; an object with query focuses the summary on a question. Billed per page (see pricing).

Example:

Response

Calculated price.

Unlike the other price endpoints, the price is returned at the top level, not inside data.

price
number<float>

What the request would cost, in USD. A quote only — nothing is charged by this endpoint.

Example:

0.0048