Skip to main content
POST
Estimate the price of a web search
Estimate the cost of a web search before running it. Send the same body you would send to Web Search — it is validated the same way, so an invalid body returns the same 422. Nothing is charged.
Unlike the other /price endpoints, this one returns the price at the top level — {"price": 0.0048} — not inside data.
The price depends on mode, limit and whether summary is requested. text, excerpts, filters and the query itself do not change it.

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
query
string
required

What to search for, in natural language or as keywords.

Maximum string length: 2000
Example:

"open source text to image models 2026"

mode
enum<string>
default:balanced

quick is the fastest and cheapest; balanced takes a little longer, returns better-ranked results and is the only mode that can return summary. Defaults to balanced.

Available options:
quick,
balanced
Example:

"quick"

limit
integer
default:10

Maximum number of results. The base price covers up to 10 results; every result above 10 adds to the price.

Required range: 1 <= x <= 25
Example:

5

include
object

Page content to return with each result. Leave it out to get only url, title and the metadata the page exposes.

only_domains
string[]

Return results from these domains only. Bare hostnames such as deapi.ai or docs.deapi.ai — no scheme, path, port or wildcard.

Maximum array length: 50
Example:
country
string

Bias results towards a country. ISO 3166-1 alpha-2 code, case-insensitive (e.g. US, DE, PL).

Required string length: 2
Example:

"US"

published_after
string<date>

Only results published on or after this date (ISO 8601 date or date-time).

Example:

"2026-01-01"

published_before
string<date>

Only results published on or before this date (ISO 8601 date or date-time). Must not be earlier than published_after.

Example:

"2026-11-01"

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