# Google Images

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/google/images` |
| **Base URL** | `https://api.autom.dev` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/google-images |

## Description

Google Images Scraper API – bringing the power of visual search to your fingertips.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.autom.dev/register

## Example Request

```bash
curl --location --request GET 'https://api.autom.dev/v2/google/images' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Image search 'mountain landscape'

```json
{
  "images": [
    {
      "url": "https://thumbs.dreamstime.com/b/stunning-mountain-landscape-crystal-clear-flowing-stream-breathtaking-photo-realistic-scene-majestic-lush-358650506.jpg",
      "link": "https://www.dreamstime.com/stunning-mountain-landscape-crystal-clear-flowing-stream-breathtaking-photo-realistic-scene-majestic-lush-image358650506",
      "title": "Stunning Mountain Landscape with a Crystal Clear Flowing Stream",
      "domain": "www.dreamstime.com",
      "source": "Dreamstime.com",
      "position": 1,
      "image_width": 800,
      "image_height": 449
    },
    {
      "url": "https://images.stockcake.com/public/8/8/9/889c1161-ac90-403a-b63f-23d708e67520_large/sunset-mountain-landscape-stockcake.jpg",
      "link": "https://www.pexels.com/photo/mountain-landscape-with-forests-and-a-stream-18682254/",
      "title": "Mountain Landscape with Forests and a Stream",
      "domain": "www.pexels.com",
      "source": "Pexels",
      "position": 2,
      "image_width": 728,
      "image_height": 408
    },
    {
      "url": "https://images.pexels.com/photos/18682254/pexels-photo-18682254/free-photo-of-mountain-landscape-with-forests-and-a-stream.jpeg",
      "link": "https://www.dreamstime.com/photos-images/mountain-landscape-canada.html",
      "title": "Mountain Landscape Canada Stock Photos",
      "domain": "www.dreamstime.com",
      "source": "Dreamstime.com",
      "position": 3,
      "image_width": 4032,
      "image_height": 3024
    }
  ],
  "search_parameters": {
    "q": "mountain landscape",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "engine": "google"
  }
}
```

### Image search 'lion'. Wikipedia example

```json
{
  "images": [
    {
      "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/7/73/Lion_waiting_in_Namibia.jpg/1200px-Lion_waiting_in_Namibia.jpg",
      "link": "https://en.wikipedia.org/wiki/Lion",
      "title": "Lion - Wikipedia",
      "domain": "en.wikipedia.org",
      "source": "Wikipedia",
      "position": 1,
      "image_width": 1200,
      "image_height": 900
    },
    {
      "url": "https://cdn.britannica.com/30/150930-120-D3D93F1E/lion-Namibia.jpg",
      "link": "https://www.britannica.com/animal/lion",
      "title": "Lion | Characteristics, Habitat ...",
      "domain": "www.britannica.com",
      "source": "Britannica",
      "position": 2,
      "image_width": 900,
      "image_height": 675
    },
    {
      "url": "https://c02.purpledshub.com/uploads/sites/62/2019/10/Federico_Veronesi_Lions-cover-image-e359a4e.jpg",
      "link": "https://www.discoverwildlife.com/animal-facts/mammals/facts-about-lions",
      "title": "Lion guide: species facts and where to see lions in the wild",
      "domain": "www.discoverwildlife.com",
      "source": "BBC Wildlife Magazine",
      "position": 3,
      "image_width": 3710,
      "image_height": 4000
    }
  ],
  "search_parameters": {
    "q": "lion",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "engine": "google"
  }
}
```

## Documentation

## Overview
Scrape image results from Google Images for any search query. Returns image URLs, source pages, titles, dimensions, and positions.

## Quickstart
```
POST https://api.piloterr.com/v2/google/images
Content-Type: application/json

{"query": "mountain landscape", "gl": "us", "hl": "en"}
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | The image search query |
| `gl` | string | no | 2-letter country code |
| `hl` | string | no | 2-letter language code |
| `page` | integer | no | Page number (default: 1) |

## Main use cases
- Build visual asset databases by collecting Google Images results at scale
- Monitor brand imagery by tracking images for company or product queries
- Power image-based content discovery features in creative tools
- Audit competitor visual presence through brand-specific image searches