Web Search
Pricing
from $1.00 / 1,000 google 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.
Operators like site: pass through unchecked. Use allowedDomains and blockedDomains to enforce domain filters, and dateFrom and dateTo for dates.
Google is the default search engine, supports location, and returns the most data. DuckDuckGo has no location, covers fewer countries, and fills fewer fields. Use it for a second, independent ranking, or when Google finds nothing. Each search is charged separately.
Maximum number of organic results to return. Leave it empty to get every result on the page. You get fewer when the page has fewer, or when domain filters remove some.
ISO 639-1 code with an optional region suffix, like "en", "de", or "pt-BR". See https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes. Google uses it to localize the interface and bias ranking, without translating or strictly filtering results. DuckDuckGo picks the matching regional variant, or the country's default.
ISO 3166-1 alpha-2 code, like "US", "DE", or "CZ". The search runs as if you were in that country, changing result order and which local businesses appear. Google queries that country's domain (google.de for "DE"). DuckDuckGo picks the matching region, preferring the languageCode variant ("CA" with "fr") over the default. Results aren't limited to sites hosted or registered there. Web Search returns INVALID_COUNTRY if the provider has no market there.
A place name, most specific first, like "Paris, Ile-de-France, France". Google treats it as your location for local and "near me" results. It doesn't filter pages. It's best-effort and not validated: Google may ignore places it can't resolve. Using it with DuckDuckGo returns INVALID_PARAMETER.
The earliest publication date to include. Best-effort. See the README.
The latest publication date to include. Best-effort. See the README.
Return only results from these domains. You can list up to 10 domains. A domain matches itself and its subdomains, so "wikipedia.org" covers "en.wikipedia.org". A top-level domain like "gov" matches every domain under it. Examples: "wikipedia.org", "docs.python.org", "gov".
