ScrapeUnblocker Documentation

The Google Images plugin turns a Google Images search into structured JSON. Give it a keyword, and it returns the image results Google shows - each with the full-resolution original image URL, the source domain, the source page URL, a title, a thumbnail and the image dimensions. Unlike the old Google Images layout (where the original was hidden behind a click), the current results page carries every result’s origin image URL inline, so imageUrl is the real original image on the publisher’s site - not a Google thumbnail. It runs on the same warm, anti-bot-cleared Google sessions as our SERP endpoint, so you get the image grid without touching Google’s hidden internals.

Try it in the dashboard first: app.scrapeunblocker.com/dashboard/plugins. You get a live image grid plus a copy-paste snippet.

Endpoint

POST /images/google-search

Field	Required	Notes
`q`	yes	Image search term, e.g. `eiffel tower` or `red running shoes`.
`proxy_country`	no	Exit-IP country (ISO-2, e.g. `US`, `GB`). Image ranking is location-sensitive - set the market you want.
`gl`	no	Google country of search (ISO-2 lowercase, e.g. `us`, `de`).
`max_results`	no	How many results to return, `1`-`100`. One render returns the first page (~100 results). Default `100`.

curl -X POST "https://api.scrapeunblocker.com/images/google-search?q=eiffel%20tower&proxy_country=US&gl=us&max_results=30" \
  -H "x-scrapeunblocker-key: YOUR_API_KEY"

Response

A JSON object with a results array plus counts:

{
  "query": "eiffel tower",
  "hl": "en",
  "gl": "us",
  "proxyCountry": "US",
  "resultsCollected": 30,
  "results": [
    {
      "imageUrl": "https://cdn.britannica.com/31/255531-050-B7E07090/eiffel-tower-paris-france.jpg",
      "sourceDomain": "britannica.com",
      "sourcePageUrl": "https://www.britannica.com/topic/Eiffel-Tower-Paris-France",
      "title": "Eiffel Tower | History, Height, Facts",
      "sourceName": "Encyclopedia Britannica",
      "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9Gc...",
      "width": 1600,
      "height": 1067,
      "fileSize": "418KB"
    }
  ]
}

Field	Notes
`imageUrl`	The full-resolution original image URL on the source site (not a Google thumbnail). Present for every result.
`sourceDomain`	The domain Google attributes the image to (the site displaying it), e.g. `britannica.com`. Present for every result.
`sourcePageUrl`	The page that displays the image.
`title`	The result’s title / page title.
`sourceName`	The human-readable site name (e.g. `Encyclopedia Britannica`), when present.
`thumbnailUrl`	A Google-hosted thumbnail (fast to load), when present.
`width` / `height`	Original image dimensions in pixels.
`fileSize`	Google’s reported file size (e.g. `418KB`, `1.4MB`), when present.

imageUrl and sourceDomain are returned for every result. sourcePageUrl, title, dimensions and file size are present for essentially all results; sourceName and thumbnailUrl are best-effort. A given origin host may still refuse to serve its image to an arbitrary client (hotlink protection) - the plugin returns the correct URL; whether that host hands the bytes to you is the host’s own policy.

What you can build

Image sourcing - find real, full-resolution images for a keyword and follow each back to the site that published it.
Brand / visual monitoring - see which sites rank in Google Images for your brand or product terms.
Dataset building - collect image URLs plus source attribution for training or research (respecting each source’s rights).
Reverse-sourcing - map which domains carry imagery for a topic and at what resolution.

Get Started

No-code area

Spider Cloud

Plugins

AI Assistants

Guides

Code Examples

Google Images plugin

Endpoint

Response

What you can build

Next steps

Open the plugins

Get an API key

​Endpoint

​Response

​What you can build

​Next steps

Open the plugins

Get an API key

Endpoint

Response

What you can build

Next steps