> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Images plugin

> Google Images results as clean JSON - the full-resolution image URL and source domain for every result, plus the source page, title, thumbnail and dimensions. One request, no scraping the image grid yourself.

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.

<Note>
  Try it in the dashboard first: [app.scrapeunblocker.com/dashboard/plugins](https://app.scrapeunblocker.com/dashboard/plugins). You get a live image grid plus a copy-paste snippet.
</Note>

## 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`. |

```bash theme={null}
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:

```json theme={null}
{
  "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.                                                   |

<Note>
  `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.
</Note>

## 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.

## Next steps

<CardGroup cols={2}>
  <Card title="Open the plugins" icon="play" href="https://app.scrapeunblocker.com/dashboard/plugins">
    Run a Google Images search and grab the JSON.
  </Card>

  <Card title="Get an API key" icon="key" href="https://scrapeunblocker.com/pricing">
    Free trial available on the pricing page.
  </Card>
</CardGroup>