# Google Images

Search and scrape image results from Google Images with advanced filtering by size, type, color, and aspect ratio. Returns structured data including thumbnail URLs, full-resolution original image URLs, source attribution, and image dimensions for each result.

### Key Features

- **Image metadata extraction** — Get titles, source websites, thumbnails, and original high-resolution image URLs in a single request
- **Advanced filtering** — Filter results by image size (large, medium, icon), type (photo, clipart, lineart, gif, face), dominant color (14 options), and aspect ratio (tall, square, wide)
- **Localization support** — Target results by language (`hl`) and country (`gl`) for region-specific image search
- **Pagination** — Retrieve multiple pages of results to access hundreds of images per query
- **Time-based filtering** — Use the `tbs` parameter to find images from the past day, week, month, or year
- **Safe search** — Enable or disable explicit content filtering for content-appropriate results

### Common Use Cases

- **E-commerce product research** — Gather product images and visual competitive intelligence across marketplaces
- **Content creation and curation** — Find reference images, stock photos, and visual assets for blogs, presentations, and marketing materials
- **Brand monitoring** — Track where brand logos and product images appear across the web
- **Visual dataset collection** — Build image datasets for machine learning training, computer vision projects, and AI model development
- **SEO and visual search analysis** — Monitor which images rank for specific queries and analyze visual SERP features
- **Market trend analysis** — Identify trending visual styles, design patterns, and popular imagery in any niche

- **Documentation:** [https://scrappa.co/docs/google-images-api/google_images](https://scrappa.co/docs/google-images-api/google_images)
- **API group:** Google Images API
- **Endpoint:** `GET https://scrappa.co/api/images`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `q` | string | Yes | The search term for Google Images. Supports natural language queries (e.g., "sunset over mountains") and advanced operators. |
| `page` | integer | No | Page number for pagination (default: 1). Each page returns approximately 10 image results. |
| `hl` | string | No | ISO 639-1 language code for results (e.g., `en`, `de`, `fr`, `es`, `ja`). Controls the language of titles and source text. If omitted, uses Google's default based on location. |
| `gl` | string | No | ISO 3166-1 alpha-2 country code for geo-targeting (e.g., `us`, `de`, `uk`, `jp`). Prioritizes images from websites in the specified country. |
| `imgsz` | string | No | Filter by image size. Accepted values: `large` (high-resolution images), `medium` (standard web images), `icon` (small thumbnails and icons). |
| `imgtype` | string | No | Filter by image type. Accepted values: `photo` (photographs), `clipart` (clip art), `lineart` (line drawings), `gif` (animated GIFs), `face` (images containing faces). |
| `imgcolor` | string | No | Filter by dominant color. Accepted values: `color`, `gray`, `trans` (transparent), `red`, `orange`, `yellow`, `green`, `teal`, `blue`, `purple`, `pink`, `white`, `black`, `brown`. |
| `imgar` | string | No | Filter by aspect ratio. Accepted values: `tall` (portrait orientation), `square` (1:1 ratio), `wide` (landscape orientation). |
| `tbs` | string | No | Advanced time-based filters using Google's `tbs` syntax. Examples: `qdr:d` (past 24 hours), `qdr:w` (past week), `qdr:m` (past month), `qdr:y` (past year). |
| `safe` | string | No | Safe search filtering. Accepted values: `active` (filter explicit content), `off` (no filtering). Recommended to set `active` for public-facing applications. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/images?q=coffee"
```

## Example response

```json
[
    {
        "position": 1,
        "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRwFJxoG4xATI9dZKguBAl_LbsmREXYKpdAtg",
        "source": "Wikipedia",
        "title": "Coffee - Wikipedia",
        "link": "https://en.wikipedia.org/wiki/Coffee",
        "original": "https://upload.wikimedia.org/wikipedia/commons/e/e4/Latte_and_dark_coffee.jpg",
        "original_width": 3200,
        "original_height": 2000,
        "is_product": false
    },
    {
        "position": 2,
        "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTwsIC3x_NQ3ANjgHZrqshWkXgMhNRR_jUHxBq",
        "source": "Americano Lounge",
        "title": "What is American Style Coffee? - Americano Lounge",
        "link": "https://www.americanolounge.com/what-is-american-style-coffee/",
        "original": "https://www.americanolounge.com/wp-content/uploads/2024/08/american-style-coffee.webp",
        "original_width": 1920,
        "original_height": 1280,
        "is_product": false
    },
    {
        "position": 3,
        "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSk45hpbY7alvCv5r0UDuDG6G8uEJu6G7pChSa",
        "source": "Uno Casa",
        "title": "Types of Coffee: A Fully-Brewed Coffee Guide",
        "link": "https://unocasa.com/blogs/tips/types-of-coffee",
        "original": "https://unocasa.com/cdn/shop/articles/types_of_coffee_1024x.jpg",
        "original_width": 1024,
        "original_height": 683,
        "is_product": false
    }
]
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The q, page, locale, safe search, or image filter parameters are missing or invalid. |
| 502 | The upstream service is temporarily unavailable. Please retry shortly. | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)