Skip to main content
POST
Search the web
Search the live web and get ranked results in a single call — optionally with each page’s clean text, the passages most relevant to your query, and an AI-written summary. Built for AI agents, RAG pipelines and research tools that need fresh, citable sources.
Synchronous. Results come back in the response body. There is no request_id to poll, no webhook and no job status — request_id in the response is only an identifier for support. The amount charged is returned in cost.

Modes

Getting page content with the results

Leave include out to get only url, title and whatever metadata the page exposes (published_at, author, image). Add any of these to include to get page content in the same call:
  • text — the page as clean text. true returns up to 20,000 characters; {"max_length": 5000} sets your own cap (1–100,000).
  • excerpts — the passages most relevant to your query. {"query": "..."} steers them towards a different question.
  • summary — an AI-written summary of each result (balanced mode only). {"query": "..."} focuses it on a question.
Optional fields are omitted from a result when the page does not provide them — check for presence rather than null.

Filters

  • only_domains — up to 50 bare hostnames (deapi.ai, docs.deapi.ai). No scheme, path, port or wildcard.
  • country — ISO 3166-1 alpha-2 code (US, DE, PL) to bias results towards a country.
  • published_after / published_before — ISO 8601 dates; published_before cannot be earlier than published_after.

Example

Response

Pricing

Use Web Search Price to get the exact quote for a request body. See also Pricing.
Already have the URLs? Use Web Contents to read specific pages instead of searching.

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

Search results.

Returned directly — there is no data envelope and no job to poll.

request_id
string<uuid>

Identifier of this request, useful when contacting support.

Example:

"ba1e1b58-a12c-4f83-9ec7-572e301fa1c2"

cost
number<float>

What this request was charged, in USD. Matches the amount deducted from the balance and reported by the usage endpoints.

Example:

0.0048

results
object[]