Google Search Scraper

Get Google search results as structured JSON. Web results, image results, and Knowledge Graph entities with auto-pagination up to 100 results.

Unlike SERP scrapers that load Google in a browser and parse HTML, this queries Google's API directly. No browser, no CAPTCHAs, no breakage when Google redesigns their page. The trade-off: you get organic results, images, and Knowledge Graph only — no ads, People Also Ask, or AI overviews.

Quick start

{
  "query": "web scraping best practices"
}

Default: 10 results. Set maxResults up to 100:

{
  "query": "web scraping best practices",
  "maxResults": 50
}

Image search:

{
  "query": "Tokyo Tower",
  "searchType": "image",
  "maxResults": 30
}

Geo-targeted (search as if from Japan, in Japanese):

{
  "query": "best restaurants",
  "gl": "jp",
  "hl": "ja"
}

Sort by date or restrict to a date range:

{
  "query": "climate change policy",
  "sort": "date:r:20250101:20250601"
}

Input

Parameter	Type	Default	Description
query	string	required	Google search query. Supports operators: "exact phrase", -exclude, site:example.com, filetype:pdf
maxResults	integer	10	Max results (1–100)
gl	string	—	Country code for geo-targeting (us, vn, jp)
hl	string	—	Interface language (en, vi, ja)
sort	string	—	Sort expression (see below)
searchType	string	web	web or image
knowledgeGraphLimit	integer	5	Max Knowledge Graph entities. 0 to disable
proxyConfiguration	object	Apify proxy	Proxy settings

Sort options

The sort parameter accepts expressions that control result ordering.

Sort by date:

Value	Description
date	Newest first
date:a	Oldest first

Bias by date (promotes recent/old results without excluding undated pages):

Value	Description
date:d:s	Strong bias toward recent
date:d:w	Weak bias toward recent
date:a:s	Strong bias toward older

Restrict to date range (format YYYYMMDD):

Value	Description
date:r:20250101:20250601	Jan–Jun 2025 only
date:r:20250101:	From Jan 2025 onward
date:r::20250101	Before Jan 2025

Sort by structured data (when pages have PageMaps):

Value	Description
review-rating:d	By rating, descending
review-rating:d:s	Bias toward high ratings
review-rating:d:s,review-date:d:w	High rating + recent
review-rating,review-rating:r:3.0:	By rating, minimum 3.0

Output

Each search result is one row in the dataset.

Web search:

{
  "title": "My ultimate guide to web scraping : r/datascience - Reddit",
  "link": "https://www.reddit.com/r/datascience/comments/a116l5/my_ultimate_guide_to_web_scraping/",
  "displayLink": "www.reddit.com",
  "snippet": "Nov 28, 2018 ... Excellent tutorial. I particularly like saving the html files in case something goes wrong with the scraping. This is also a good idea ...",
  "pagemap": {
    "metatags": [
      {
        "og:image": "https://share.redd.it/preview/post/a116l5",
        "og:type": "website",
        "og:site_name": "Reddit",
        "og:title": "r/datascience on Reddit: My ultimate guide to web scraping",
        "og:description": "Posted by u/brendanmartin - 197 votes and 26 comments"
      }
    ]
  },
  "html": {
    "title": "My ultimate guide to <b>web scraping</b> : r/datascience - Reddit",
    "snippet": "Nov 28, 2018 <b>...</b> Excellent tutorial. I particularly like saving the html files in case something goes wrong with the <b>scraping</b>. This is also a <b>good</b> idea&nbsp;..."
  }
}

Image search adds image, mime, and fileFormat:

{
  "title": "Tokyo Tower - Wikipedia",
  "link": "https://upload.wikimedia.org/wikipedia/commons/thumb/5/58/Tokyo_Tower_2023.jpg/960px-Tokyo_Tower_2023.jpg",
  "displayLink": "en.wikipedia.org",
  "snippet": "Tokyo Tower - Wikipedia",
  "mime": "image/jpeg",
  "fileFormat": "image/jpeg",
  "image": {
    "contextLink": "https://en.wikipedia.org/wiki/Tokyo_Tower",
    "height": 1280,
    "width": 960,
    "byteSize": 381361,
    "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTmKU8xLi6M5YTijS2AVf-81zQJrZZXE4sK7MxOXBnwzgXoPUn5cbZ22no&s",
    "thumbnailHeight": 150,
    "thumbnailWidth": 113
  },
  "html": {
    "title": "<b>Tokyo Tower</b> - Wikipedia",
    "snippet": "<b>Tokyo Tower</b> - Wikipedia"
  }
}

The html fields contain the same title/snippet with bold tags around matching keywords.

Key-value store

SEARCH_INFO stores search metadata on the first page:

{
  "searchInformation": {
    "searchTime": 0.680919,
    "formattedSearchTime": "0.68",
    "totalResults": "17800000",
    "formattedTotalResults": "17,800,000"
  },
  "spelling": null,
  "promotions": null,
  "context": { "title": "..." },
  "queries": {
    "request": [
      {
        "title": "Google Custom Search - web scraping best practices",
        "totalResults": "17800000",
        "searchTerms": "web scraping best practices",
        "count": 10,
        "startIndex": 1
      }
    ],
    "nextPage": [
      {
        "totalResults": "17800000",
        "searchTerms": "web scraping best practices",
        "count": 10,
        "startIndex": 11
      }
    ]
  },
  "searchParameters": {
    "query": "web scraping best practices",
    "gl": null,
    "hl": null,
    "sort": null,
    "searchType": "web"
  }
}

KNOWLEDGE_GRAPH stores entities matching your query:

{
  "@type": "ItemList",
  "itemListElement": [
    {
      "resultScore": 6953.152832,
      "@type": "EntitySearchResult",
      "result": {
        "url": "http://www.tokyotower.co.jp/english/",
        "name": "Tokyo Tower",
        "description": "Tower in Minato, Japan",
        "@type": ["Place", "Thing", "CivicStructure", "TouristAttraction", "Organization"],
        "@id": "kg:/m/0132_x",
        "detailedDescription": {
          "url": "https://en.wikipedia.org/wiki/Tokyo_Tower",
          "articleBody": "Tokyo Tower, a.k.a. Japan Radio Tower is a communications and observation tower in the district of Shiba-koen in Minato, Tokyo, Japan, completed in 1958. At 332.9 metres, it was the tallest tower in Japan until the construction of Tokyo Skytree in 2012."
        }
      }
    }
  ]
}

Limitations

• 100 results max per query, 10 per page
• Results may vary by proxy region even with gl set
• Not all queries return Knowledge Graph entities
• sort uses Google's date format (YYYYMMDD), not ISO dates
• No ads, People Also Ask, or AI overviews (use a SERP scraper for those)