Skip to main content
POST /v1/data/web/search/run Pricing: $0.001 per result ($1.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
One or more search queries, written the way you would ask a search engine. Each query returns its own ranked results.
integer
default:"10"
How many results to return for each query, up to 20. Defaults to 10; use 0 for the maximum of 20.Min 0; max 20.
string
Two-letter country code to localise results to, e.g. us, in or gb. Leave blank for no country preference.
string
default:"any"
Only return pages published within this window. Pages with no published date are kept.Allowed values: any (Any time), day (Past day), week (Past week), month (Past month), year (Past year).
string[]
Only return results from these domains (and their subdomains), e.g. reuters.com. Up to 20.Format e.g. stripe.com.
string[]
Never return results from these domains (and their subdomains), e.g. pinterest.com. Up to 20.Format e.g. stripe.com.

Example

Response fields

Each row in data is one result, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For Google’s own ranking use google/search; for the full text of a result use web/scrape.