This Google Images scraper API searches public Google Images results and exports clean image-search metadata for recurring SEO, brand, content, and visual research. Use the Google Images API to export Google Images data as structured rows for repeatable workflows. Submit one or many queries; each result is returned as a separate dataset row with its source page and image URLs.
What you get
- Batch keyword searches with country (
gl) and language (hl) localization - Full-size image URL, thumbnail, dimensions, source page, domain, and result rank
- Google image and result IDs, page number, and query provenance for recurring comparisons
- JSON, CSV, Excel, JSONL, API, scheduled tasks, and Apify MCP access
Example input
{
"queries": ["golden retriever puppy", "eiffel tower at night"],
"maxResultsPerQuery": 50,
"gl": "us",
"hl": "en"
}
maxResultsPerQuery is a ceiling, not a guarantee. Google can return fewer results for a niche query.
Output example
{
"query": "eiffel tower at night",
"position": 1,
"title": "Eiffel Tower at night, Illuminations & light show - OFFICIAL ...",
"imageUrl": "https://www.toureiffel.paris/.../4k0a9297-compressed.jpg",
"imageWidth": 1200,
"imageHeight": 630,
"thumbnailUrl": "https://encrypted-tbn0.gstatic.com/...",
"source": "La tour Eiffel",
"domain": "www.toureiffel.paris",
"link": "https://www.toureiffel.paris/en/the-monument/lights",
"page": 0,
"gl": "us",
"hl": "en"
}
Input settings
| Field | Description |
|---|---|
queries |
One or more Google Images search queries. |
maxResultsPerQuery |
Maximum image rows per query, from 1 to 1,000. |
gl |
Two-letter country code, such as us, gb, or de. |
hl |
Two-letter language code, such as en, es, or de. |
proxyConfiguration |
Optional Apify Proxy configuration. The Actor tries the public route directly first and uses the configured proxy after a block. |
Use cases
- Monitor image-search visibility for a brand, product, or topic
- Build a list of image URLs and source pages for editorial research
- Compare localized image-search results over time
- Feed image-search metadata into AI, SEO, and content workflows
Workflow tips
- Start with one specific query and a modest result limit to confirm relevance.
- Keep
glandhlfixed when comparing recurring snapshots. - Use multiple queries when you need a consistent export for a content calendar or brand audit.
- Export to CSV or JSONL when downstream tools need a tabular image URL inventory.
Data notes
Results reflect the public search page at the time of the run. Titles, source pages, image URLs, and dimensions can change after collection. An image result can point to a publisher-controlled page that later moves or restricts access; retain the returned source link for attribution and follow-up.
Who is it for
This API is for SEO teams, content researchers, agencies, developers, and AI workflows that need repeatable Google Images result metadata rather than manual browser exports. It is especially useful when the same query set must be refreshed by market, language, or schedule.
API usage
Node.js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/google-images-api-scraper').call({
queries: ['eiffel tower at night'], maxResultsPerQuery: 25, gl: 'us', hl: 'en',
});
const items = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.items);
Python
from apify_client import ApifyClient
client = ApifyClient("<APIFY_TOKEN>")
run = client.actor("fetch_cat/google-images-api-scraper").call(run_input={
"queries": ["eiffel tower at night"], "maxResultsPerQuery": 25, "gl": "us", "hl": "en"
})
print(client.dataset(run["defaultDatasetId"]).list_items().items)
cURL
curl -X POST "https://api.apify.com/v2/acts/fetch_cat~google-images-api-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"queries":["eiffel tower at night"],"maxResultsPerQuery":25,"gl":"us","hl":"en"}'
MCP
Add the Actor to an MCP-enabled client:
claude mcp add apify -- npx -y @apify/mcp-server
{
"mcpServers": {
"apify": { "command": "npx", "args": ["-y", "@apify/mcp-server"] }
}
}
Use https://mcp.apify.com/?tools=fetch_cat/google-images-api-scraper to scope tools to this Actor. Example prompt: “Run Google Images research for three product terms in the US and return image URLs with source domains.”
Tips and limits
Use specific text queries for the most relevant results. This Actor returns public search-result metadata, not image files; follow the returned source URLs and respect each publisher’s terms and rights before downloading or reusing content. Google may rate-limit or block requests, so occasional partial results are possible.
Support
Open an issue on this Actor’s Apify page with the input JSON, expected versus actual output, a reproducible public Google Images URL, and the run ID. Never include credentials or private data.
