Web Search
Pricing
from $1.00 / 1,000 search results
Search the web and get organic results as JSON with title, URL, snippet, and position. You can filter by date, country, language, and domain. The Actor provides a real-time API.
Plain search text, passed to the provider verbatim. Engine operator syntax (site:, intitle:, ...) is not supported - use allowedDomains/blockedDomains and dateFrom/dateTo instead.
Search engine to query. "google" is the only supported value in v1.
Maximum number of organic results to return. When omitted, every organic result on the fetched results page is returned. Fewer results come back when the page holds fewer, or when the domain filters drop some.
ISO 639-1 language code, for example "en", "de", "cs" - see https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes. A region suffix such as "pt-BR" is accepted too. It sets the language of the search engine interface and biases ranking toward pages written in that language. Results are neither translated nor strictly filtered by language.
ISO 3166-1 alpha-2 country code, for example "US", "DE", "CZ". The search runs as if issued from that country: the matching Google domain is queried (google.de for "DE") and results are ranked for that market, which changes both the ordering and which local businesses appear. It does not restrict results to websites hosted or registered in that country. A country Google has no search domain for is rejected with INVALID_COUNTRY.
Human-readable place name, most specific first, for example "Paris, Ile-de-France, France". It is applied to the search engine only, as the searcher's presumed location, so local and "near me" results match that place. It does not filter the pages themselves. Best-effort and not validated: Google may ignore a place it cannot resolve.
Inclusive lower bound on publication date. Best-effort - see the README.
Inclusive upper bound on publication date. Best-effort - see the README.
Return only results from these domains. Max 10. A domain matches itself and all of its subdomains, so "wikipedia.org" also matches "en.wikipedia.org". A bare top-level domain works too: "gov" matches every domain under it. Examples: "wikipedia.org", "docs.python.org", "gov".
