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 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	Country to search from (ISO-2, e.g. `US`, `DE`). The Google market (which images rank) follows it automatically. Without it you get US-market results.
`pages`	no	How many result pages to fetch, `1`-`5`. Each page has ~100 results; Google stops at roughly 400-500 per query. Each page fetched is billed as one request (see `pagesFetched`). Default `1`.
`gl`	no	Optional Google market override (ISO-2 lowercase, e.g. `de`). Leave it empty to follow `proxy_country`; set it only for a different market than the IP country.
`max_results`	no	Optional cap on the number of results returned, `1`-`500`. Default: everything the fetched pages return.
`time_range`	no	Only images Google found within this recent period: `hour`, `day`, `week`, `month` or `year` (Google Images’ Tools > Time filter). See Only new images. Cannot be combined with `date_from` / `date_to`.
`date_from`	no	Only images Google found on or after this date, `YYYY-MM-DD`. Works alone or with `date_to`.
`date_to`	no	Only images Google found on or before this date, `YYYY-MM-DD`. Works alone or with `date_from`.

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

from scrapeunblocker import Client

su = Client()  # reads SCRAPEUNBLOCKER_KEY

result = su.google_images("eiffel tower", proxy_country="US", pages=3)

import { ScrapeUnblockerClient } from "scrapeunblocker";

const su = new ScrapeUnblockerClient(); // reads SCRAPEUNBLOCKER_KEY

const result = await su.googleImages("eiffel tower", {
  proxyCountry: "US",
  pages: 3,
});

use ScrapeUnblocker\Client;

$su = new Client(); // reads SCRAPEUNBLOCKER_KEY

$result = $su->googleImages('eiffel tower', [
    'proxy_country' => 'US',
    'pages' => 3,
]);

require "scrapeunblocker"

su = ScrapeUnblocker::Client.new # reads SCRAPEUNBLOCKER_KEY

result = su.google_images("eiffel tower", proxy_country: "US", pages: 3)

Only new images

Without a time filter, the same query returns mostly the same top results on every run. When you scan a query on a schedule (brand or content monitoring, takedown work), set time_range to the interval between scans - day for a daily scan - and you get only the images Google found in that period. For a fixed window, use date_from and date_to instead. An unknown time_range value, a date not in YYYY-MM-DD format, or date_from after date_to returns 400 with a plain-text message.

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

result = su.google_images("eiffel tower", proxy_country="US", time_range="day")

# a fixed window instead
result = su.google_images("eiffel tower", date_from="2026-10-01", date_to="2026-10-07")

const result = await su.googleImages("eiffel tower", {
  proxyCountry: "US",
  timeRange: "day",
});

$result = $su->googleImages('eiffel tower', [
    'proxy_country' => 'US',
    'time_range' => 'day',
]);

result = su.google_images("eiffel tower", proxy_country: "US", time_range: "day")

Response

A JSON object with a results array plus counts:

{
  "query": "eiffel tower",
  "hl": "en",
  "gl": "us",
  "proxyCountry": "US",
  "resultsCollected": 300,
  "pagesFetched": 3,
  "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",
      "googleImagesUrl": "https://www.google.com/imgres?q=eiffel%20tower&imgurl=https%3A%2F%2Fcdn.britannica.com%2F31%2F255531-050-B7E07090%2Feiffel-tower-paris-france.jpg&imgrefurl=https%3A%2F%2Fwww.britannica.com%2Ftopic%2FEiffel-Tower-Paris-France&docid=kZ9Xr2mFqL8AbM&tbnid=Xy7Qm2ntAbCDeM&w=1600&h=1067&hcb=2&ved=2ahUKEw..."
    }
  ]
}

Field	Notes
`imageUrl`	The full-resolution original image URL on the source site (not a Google thumbnail). Present for every result. Exception: an image Google found inside a document such as a PDF has no URL of its own - there `imageUrl` is Google’s thumbnail and `sourcePageUrl` is the document.
`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.
`googleImagesUrl`	The Google Images tile link (`/imgres?...`) for this result - the same format a desktop browser copies from the result tile (“Copy link address”), rebuilt from the tile’s own ids: `q`, `imgurl`, `imgrefurl`, `docid`, `tbnid`, `w`, `h`, `hcb` and `ved`. The identifiers (`docid`, `tbnid`, `imgurl`, `imgrefurl`) match Google’s exactly; `ved` is a per-search-session token (Google mints a fresh one each search, so it never matches across sessions). Returned for every result.

imageUrl, sourceDomain and googleImagesUrl 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

Only new images

Response

What you can build

Next steps

Open the plugins

Get an API key

​Endpoint

​Only new images

​Response

​What you can build

​Next steps

Open the plugins

Get an API key

Endpoint

Only new images

Response

What you can build

Next steps