POST /v1/data/web/search/run
Pricing: $0.001 per result ($1.00 per 1,000).
Request
Send the inputs underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
One or more search queries, written the way you would ask a search engine. Each query returns its own ranked results.
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.Two-letter country code to localise results to, e.g. us, in or gb. Leave blank for no country preference.
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).Only return results from these domains (and their subdomains), e.g. reuters.com. Up to 20.Format e.g.
stripe.com.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 indata is one result, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For Google’s own ranking usegoogle/search; for the full text of a result use web/scrape.