Skip to main content
POST /v1/data/google/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
A Google search query or full search URL. Supports operators like site:, OR, intitle:, etc.Format e.g. https://www.example.com.
integer
Number of Google result pages to scrape (~10 organic results per page). Use 0 for all. Google itself returns at most ~10 pages (~100 results) per query, so higher values won’t return more.
date
Earliest result date. Leave blank for no lower bound.
date
Latest result date. Leave blank for no upper bound.
string
Country to search from (uses google.<tld> domain). Defaults to US (google.com).240 allowed values, for example af (Afghanistan), al (Albania), dz (Algeria), as (American Samoa), ad (Andorra), ao (Angola), ai (Anguilla), aq (Antarctica), ag (Antigua and Barbuda), ar (Argentina). Fetch the full list with GET /v1/data/google/search?expand=options.
string
Language of search results (e.g. only German pages).35 allowed values, for example ar (Arabic), bg (Bulgarian), ca (Catalan), cs (Czech), da (Danish), de (German), el (Greek), en (English), es (Spanish), et (Estonian). Fetch the full list with GET /v1/data/google/search?expand=options.
string
Limit to a specific site (e.g. example.com).Format e.g. stripe.com.
Find pages related to a specific site (e.g. example.com). Ignored if Site Filter is set.Format e.g. stripe.com.
string[]
Filter to specific file types (e.g. pdf, doc).

Example

Response fields

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

Example response

Abridged: long text and lists are shortened.