Google Search Scraper

Scrapes organic search results from Google for any query with country, language, and location targeting. Extracts title, URL, snippet, sitelinks, thumbnail, ratings, dates, rich result type, and more.

What this Actor collects

The Actor converts Google organic results into one clean JSON record per result, including title, canonical and displayed URLs, domain, snippet, sitelinks and rich-result metadata when present, page position, locale, and search provenance.

• Uses the input limits and filters below to control the crawl.
• Stores source-backed fields defined by the 47-field dataset schema.
• Omits optional fields when the source does not expose a value instead of writing nulls or fabricated placeholders.

Use cases

• Search and competitor research
• Ranking and visibility monitoring
• Dataset and workflow enrichment

Input

Provide input in JSON. Fields marked required must be supplied. The Default / example column shows a schema default when one exists; otherwise it shows a documented prefill or fixture value.

Field	Type	Required	Default / example	Description
query	string	Yes	"Elon Musk"	The search term to use
maxItems	integer	Yes	10	Maximum number of search results to retrieve
gl	string	No	—	The Google country to use for the query
hl	string	No	—	The Google UI language to return results
lr	string	No	—	Limit the results to a specific language
cr	string	No	—	Limit the results to a specific country
time_period	string	No	—	Time period for results
time_period_min	string	No	—	Minimum date for custom time period (MM/DD/YYYY)
time_period_max	string	No	—	Maximum date for custom time period (MM/DD/YYYY)
nfpr	integer	No	—	Exclude results from auto-corrected queries (0 or 1)
filter	integer	No	—	Enable/disable Similar Results and Omitted Results filters (0 or 1)
proxyConfiguration	object	No	{"useApifyProxy":true,"apifyProxyGroups":["GOOGLE_SERP"]}	Proxy config. Use GOOGLE_SERP group for best CAPTCHA bypass on Google.

Example input

{
  "query": "climate change",
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ],
    "countryCode": "US"
  },
  "gl": "us",
  "hl": "en"
}

Output

The default dataset contains one item per organic search result. The following are the most useful fields; sitelinks, ratings, prices, dates, media, and other rich-result fields appear only when Google exposes them.

Field	Type	Description
searchQuery	string	Search Query
position	integer	Position
title	string	Title
displayedUrl	string	Displayed URL
domain	string	Domain
rating	number	Rating
ratingCount	string	Rating Count
date	string	Date
country	string	Country
language	string	Language
scrapedAt	string	Scraped At
type	string	Type
description	string	Description
snippet	string	Snippet
url	string	URL
link	string	Link

Example dataset item

This compact example is taken from local Actor storage. Long text and nested collections are shortened for documentation only.

{
  "searchQuery": "climate change",
  "position": 1,
  "title": "What Is Climate Change?",
  "domain": "un.org",
  "country": "US",
  "language": "en",
  "scrapedAt": "2026-07-23T11:51:01.823Z",
  "type": "organic",
  "snippet": "Climate change refers to long-term shifts in temperatures and weather patterns. Such shifts can be natural, due to changes in the sun's activity or large ...Read more",
  "url": "https://www.un.org/en/climatechange/what-is-climate-change",
  "link": "https://www.un.org/en/climatechange/what-is-climate-change",
  "page": 1
}

Related Actors

• Google About This Result Scraper
• Google AI Overview Scraper
• Google Autocomplete Scraper