Google Search Scraper

Apify actor that returns Google search results, image results, and Knowledge Graph entities.

Features

• Web search — auto-pagination up to 100 results per query
• Image search — image URLs, dimensions, thumbnails, source pages
• Knowledge Graph — entity data (descriptions, types, Wikipedia links)
• Geo-targeting by country and language
• Sort by date, relevance, or custom date ranges
• Date recency filtering
• Proxy support with automatic rotation

Input

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

Sort options

Value	Description
date	Newest first
date:a	Oldest first
date:d:s	Strong bias toward recent results
date:d:w	Weak bias toward recent results
date:r:20250101:20250601	Date range (Jan-Jun 2025, format YYYYMMDD)

Output

Dataset — search results (one per row)

Web search:

{
  "title": "Example Page Title",
  "link": "https://example.com/page",
  "displayLink": "example.com",
  "snippet": "A short description of the page...",
  "cacheId": "abc123",
  "pagemap": {
    "metatags": [{ "og:title": "...", "og:description": "..." }]
  },
  "html": {
    "title": "Example Page <b>Title</b>",
    "snippet": "A short description of the <b>page</b>..."
  }
}

Image search (same structure + image object):

{
  "title": "Tokyo Tower - Wikipedia",
  "link": "https://upload.wikimedia.org/.../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": 4608,
    "width": 3456,
    "byteSize": 3569727,
    "thumbnailLink": "https://encrypted-tbn0.gstatic.com/images?q=...",
    "thumbnailHeight": 150,
    "thumbnailWidth": 113
  },
  "html": { "title": "...", "snippet": "..." }
}

KVStore — search metadata and Knowledge Graph

SEARCH_INFO — search-level metadata (stored once):

• searchInformation — totalResults, searchTime
• spelling — correctedQuery (did-you-mean)
• promotions — promoted results
• context — search engine metadata
• searchParameters — input params used

KNOWLEDGE_GRAPH — Knowledge Graph entities:

{
  "@type": "ItemList",
  "itemListElement": [
    {
      "resultScore": 6953.15,
      "result": {
        "@type": ["TouristAttraction", "Place"],
        "@id": "kg:/m/0132_x",
        "name": "Tokyo Tower",
        "description": "Tower in Minato, Japan",
        "url": "http://www.tokyotower.co.jp/english/",
        "detailedDescription": {
          "articleBody": "Tokyo Tower is a communications and observation tower...",
          "url": "https://en.wikipedia.org/wiki/Tokyo_Tower"
        }
      }
    }
  ]
}

Limitations

• 100 results max per query (Google API hard limit)