# Google Images Scraper - Image Search Results & Direct URLs (`zaver.api/google-images-scraper`) Actor

Just $0.99 per 1,000 images. Scrape Google Images for any keyword - image URL, thumbnail, size, source page and domain - with country, language and date filters, 100 images per page. No proxies, no CAPTCHAs. Export CSV, JSON, Excel.

- **URL**: https://apify.com/zaver.api/google-images-scraper.md
- **Developed by:** [Zaver](https://apify.com/zaver.api) (community)
- **Categories:** Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.99 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Images Scraper - Image Search Results & Direct URLs

**Scrape Google Images at scale - direct full-size image URLs, dimensions and the page each image sits on.** Up to 100 images per request, so image datasets build quickly and cheaply.

> ⭐ up to 100 images per page · direct full-size URLs · country + language + date filters · pay per row delivered · CSV/JSON/Excel · API, MCP & schedules

### What data does it extract?

One row per image, with the `query`, `page` and `type` it came from so multi-query exports stay
separable. Fields Google does not return for an item are simply absent, and any new field Google
adds is passed through automatically.

| Field | Description |
|---|---|
| `title` | Image title or alt text |
| `imageUrl` | Direct full-size image URL |
| `imageWidth` | Width in pixels |
| `imageHeight` | Height in pixels |
| `thumbnailUrl` | Google thumbnail URL |
| `thumbnailWidth` | Thumbnail width |
| `thumbnailHeight` | Thumbnail height |
| `source` | Name of the site hosting the image |
| `domain` | Host domain |
| `link` | Page the image appears on |
| `position` | Rank within the page |
| `query` | The keyword this row came from |
| `page` | Which results page it came from |

#### Example output

```json
{
  "query": "coffee shops new york",
  "page": 1,
  "type": "image",
  "title": "Original Cafés in NYC and Where to Find Them - VIE Magazine",
  "imageUrl": "https://viemagazine.com/wp-content/uploads/2018/03/vie-magazine-cafes-of-nyc-hero-min.jpg",
  "imageWidth": 1900,
  "imageHeight": 1200,
  "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSGYwHGFCH9J2ScD-dVU0_P2FCHvxskBx2ztApFZWKsTw&s=10",
  "thumbnailWidth": 697,
  "thumbnailHeight": 439,
  "source": "VIE Magazine",
  "domain": "viemagazine.com"
}
```

### How to use it

1. Paste your queries into **`queries`** - one per line.
2. Set the options you need from the table below.
3. Run it, then download the dataset as **CSV, Excel, JSON, JSONL or XML** - or read it straight from
   the Apify API.

#### Input example

```json
{
  "queries": [
    "latte art",
    "espresso machine"
  ],
  "num": 100,
  "gl": "us",
  "hl": "en",
  "maxPages": 2
}
```

| Option | Type | Description |
|---|---|---|
| `queries` | array | **Required.** Keywords, one per line. |
| `num` | integer | Images per page, up to 100. Default 100. |
| `gl` | string | Country code - `us`, `in`, `gb`, `de`... |
| `hl` | string | Language code - `en`, `hi`, `es`... |
| `dateRange` | string | `qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y` - past hour to past year. |
| `maxPages` | integer | Pages per keyword, default 1. Each page is one request. |

### Pricing

| Event | Price |
|---|---|
| `image-result` | **$0.99 per 1,000 images** ($0.00099 per image) |

1,000 images → **$0.99** · 10,000 → **$9.90** · 100,000 → **$99.00**

You are billed per row delivered, as it is delivered. Queries that fail or return nothing cost you
nothing, and an interrupted run only ever bills the rows already in your dataset.

### Use cases

#### Build image datasets for machine learning or moderation

A single run returns hundreds of direct image URLs with dimensions, ready to download and label. `imageWidth`/`imageHeight` let you filter out thumbnails before fetching.

#### Monitor where your brand, logo or product photos appear

Search your brand terms and watch the `domain` column for sites republishing your imagery.

#### Research competitor visual positioning

See which images rank for your category keywords and which domains own that visual real estate.

#### Source reference imagery for design and content teams

Collect candidate visuals with their source page so attribution and licensing checks stay possible.

#### Audit image SEO for a topic

Find which pages win image search for your keywords, then compare their alt text and file sizes.

### Good to know

- `num` genuinely works here - up to 100 images per request, unlike Google's text search.
- `dateRange` changes which images Google returns.
- Image URLs point at third-party sites; check licensing before reuse.

### Frequently asked questions

#### Do I need proxies, an API key or a Google account?

No. Requests run through hosted Google search infrastructure on our side - nothing to configure.

#### How many images can I get per keyword?

Up to 100 per page via `num`, and `maxPages` goes deeper - so 100 keywords at 2 pages yields roughly 20,000 images. Each page is one request.

#### Do I get the full-size image or just a thumbnail?

Both. `imageUrl` is the direct full-size file on the source site, and `thumbnailUrl` is Google's cached preview.

#### Can I filter images by recency?

Yes - `dateRange` accepts `qdr:h` through `qdr:y` and genuinely changes which images Google returns.

#### Does it download the image files?

No. It returns URLs and metadata, which keeps runs fast and cheap. Download the files yourself from `imageUrl`, or chain a download step after the run.

#### How do I export Google Images results to CSV or Excel?

Download the run's dataset as CSV, Excel, JSON, JSONL or XML, or read it via the Apify API.

#### Am I charged for keywords that return no images?

No. Billing is per row delivered.

### Related Google scrapers

- [Google Search Results Scraper](https://apify.com/zaver.api/google-search-scraper) - organic rankings and People Also Ask
- [Google Videos Scraper](https://apify.com/zaver.api/google-videos-scraper) - video results across YouTube, TikTok and the web
- [Google Places Scraper](https://apify.com/zaver.api/google-places-scraper) - local business results with phone and website
- [Google Maps Scraper](https://apify.com/zaver.api/google-maps-scraper) - map places with GPS, hours and Place ID
- [Google Patents Scraper](https://apify.com/zaver.api/google-patents-scraper) - patents with inventors, assignees and dates
- [Google Shopping Scraper](https://apify.com/zaver.api/google-shopping-scraper) - products with prices, sellers and ratings

***

*Not affiliated with or endorsed by Google. Returns publicly available search results.*

# Actor input Schema

## `queries` (type: `array`):

Search queries, one per line.

## `gl` (type: `string`):

Two-letter country code for localised results, e.g. <code>us</code>, <code>in</code>, <code>th</code>, <code>gb</code>. Leave empty for default.

## `hl` (type: `string`):

Interface language code, e.g. <code>en</code>, <code>hi</code>, <code>th</code>. Leave empty for default.

## `dateRange` (type: `string`):

Restrict results to a recent period.

## `maxPages` (type: `integer`):

How many result pages to fetch per query. You are billed only per row delivered.

## `num` (type: `integer`):

Results per page (max 100).

## Actor input object example

```json
{
  "queries": [
    "apple inc"
  ],
  "gl": "",
  "hl": "",
  "dateRange": "",
  "maxPages": 1,
  "num": 100
}
```

# Actor output Schema

## `results` (type: `string`):

One dataset item per result.

## `resultsCsv` (type: `string`):

CSV download.

## `runSummary` (type: `string`):

Counts for the run.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "apple inc"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("zaver.api/google-images-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "queries": ["apple inc"] }

# Run the Actor and wait for it to finish
run = client.actor("zaver.api/google-images-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "apple inc"
  ]
}' |
apify call zaver.api/google-images-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,zaver.api/google-images-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fZ8R88yVias0mzrfh/builds/6wtAHzZ2QcPhVuqBr/openapi.json