Google Images Scraper

Scrapes rich Google Images results with original and preview URLs, source pages and domains, titles, dimensions, aspect ratio, orientation, MIME format, favicons, filters, ad flags, and search metadata.

What this Actor collects

The Actor converts Google Images results into one clean JSON record per image, including original and preview URLs, source page and domain, title, dimensions, aspect ratio, orientation, MIME format, filters, ad flags, and search provenance when available.

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

Use cases

• Visual research
• Image-source discovery
• Media and asset 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	"sunset photography"	The image search term to use
maxItems	integer	Yes	20	Maximum number of image results to retrieve
gl	string	No	—	The Google country to use for the query
hl	string	No	—	The Google UI language to return results
imageSize	string	No	"any"	Filter images by size
imageType	string	No	"any"	Filter images by type
imageColor	string	No	"any"	Filter images by color mode
proxyConfiguration	object	No	{"useApifyProxy":true,"apifyProxyGroups":["GOOGLE_SERP"]}	Apify Proxy configuration. Use RESIDENTIAL group for best results.

Example input

{
  "query": "sunset photography",
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ]
  },
  "gl": "us",
  "hl": "en",
  "imageSize": "any",
  "imageType": "any",
  "imageColor": "any"
}

Output

The default dataset contains one item per image result. The following are the most useful fields; dimensions, format, source, licensing, and other media details appear only when Google exposes them.

Field	Type	Description
position	integer	Position
thumbnail	string	Thumbnail
title	string	Title
sourceName	string	Source Name
sourceUrl	string	Source URL
imageUrl	string	Image URL
width	integer	Width
height	integer	Height
aspectRatio	number	Aspect Ratio
orientation	string	Orientation
format	string	Format
isSponsored	boolean	Is Sponsored
query	string	Query
scrapedAt	string	Scraped At
type	string	Type
url	string	URL

Example dataset item

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

{
  "position": 1,
  "thumbnail": "https://littleleapling.com/wp-content/uploads/sites/17281/2023/03/creative-sunset-silouete.jpg",
  "title": "Sunset Silhouettes | Photography Tips - littleleapling.com",
  "sourceName": "Little Leapling Photography",
  "sourceUrl": "https://littleleapling.com/2023/03/13/sunset-silhouettes/",
  "imageUrl": "https://littleleapling.com/wp-content/uploads/sites/17281/2023/03/creative-sunset-silouete.jpg",
  "width": 1067,
  "height": 1600,
  "aspectRatio": 0.6669,
  "orientation": "portrait",
  "format": "jpeg",
  "isSponsored": false
}

Related Actors

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