# Google Images Scraper (`hooli/google-images-scraper`) Actor Scrape image details from images.google.com. Add your query and number of images and extract image details such as image URL, image source, description, image dimensions, thumbnail, and more. Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools. - **URL**: https://apify.com/hooli/google-images-scraper.md - **Developed by:** [Hooli](https://apify.com/hooli) (Apify) - **Categories:** SEO tools - **Stats:** 4,674 total users, 313 monthly users, 99.3% runs succeeded, 72 bookmarks - **User rating**: 4.81 out of 5 stars ## Pricing from $1.90 / 1,000 scraped images This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### 🌌 What is Google Images Scraper? Google Images Scraper is a web scraping tool that enables you to quickly extract image data from [images.google.com](https://images.google.com/). Just **enter your image search query and number of images** and extract image details such as image URLs, image dimensions, image sizes, website of origin, and more. ### πŸŒ„ What image data can this scraper extract? Google Images Scraper is capable of extracting image details such as:
πŸ” Query 🌐 Website of origin of the image
πŸ“„ Page title πŸ–ΌοΈ Image URL
πŸ“ Image width πŸ“ Image height
πŸ–ΌοΈ Thumbnail URL 🌐 Page URL
πŸ“ Thumbnail width πŸ“ Thumbnail height
### πŸŒ…Β Why scrape Google images? Google Image Search is a widely used search platform with billions of users. Here are just some of the ways you could use that data: - Analyze image trends for market research - Monitor brand mentions and image usage - Gather data for image-based SEO analysis - Collect images for training AI models ### πŸ’Έ How much does it cost to scrape images from Google? This scraper uses a pay-per-event pricing model. You are charged a fixed price for specific events such as: - **Image scraped** (`image-scraped`) β€” charged once per image result returned Check the [pricing tab](https://apify.com/hooli/google-images-scraper/pricing) for the exact cost per event. Apify provides you with $5 free usage credits every month on the [Apify Free plan](https://apify.com/pricing). ### 🏞 How do I use Google Images Scraper to extract image data? This Google Images Scraper was designed for an easy start even if you've never extracted image data from the web before. Here's how you can scrape data from Google Images search with this tool: 1. Create a [free Apify account](https://console.apify.com/sign-up) using your email. 2. Open [Google Images Scraper](https://apify.com/hooli/google-images-scraper). 3. Enter your search query and the number of images you want to extract. 4. Click "Start" and wait for the data to be extracted. 5. Export your Google Images data in Excel, CSV, JSON, HTML. You can also follow the guide for [scraping Google images](https://blog.apify.com/how-to-scrape-google-images/). Or watch this video for guidance: https://www.youtube.com/watch?v=Zvr4awK92oo ### ⬇️ Input The input for Google Images Scraper should be **one or multiple search queries**. Here's a simple input example of scraping images by Alfons Mucha: ```json { "queries": ["Alfons Mucha"], "maxResultsPerQuery": 300 } ```` Click on the [input tab](https://apify.com/hooli/google-images-scraper/input-schema) for a full explanation of input parameters. ### ⬆️ Output sample The extracted Google Images data will be shown as a dataset, which you can find in the **Output tab**. It will contain the information you specified in your search, such as image URLs, image dimensions, image sizes, and more. [![Google Image Search API](https://github.com/apify-projects/actor-readme-images/blob/master/Google%20images%20API.png?raw=true)](https://console.apify.com/actors/tnudF2IxzORPhg4r8/console/) You can preview all the fields in the **Storage** and **Output** tabs and choose the format in which to export the Google Images data you've extracted: JSON, CSV, Excel, or HTML table. Here below is the same sample dataset in JSON: ```json [{ "query": "Alfons Mucha", "origin": "simple.wikipedia.org", "title": "Alphonse Mucha - Simple English Wikipedia, the free encyclopedia", "imageUrl": "https://upload.wikimedia.org/wikipedia/commons/thumb/b/bd/Alfons_Mucha_-_F._Champenois_Imprimeur-%C3%89diteur.jpg/1200px-Alfons_Mucha_-_F._Champenois_Imprimeur-%C3%89diteur.jpg", "imageWidth": 1200, "imageHeight": 1630, "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQXLRmm59tZoOT4I5Q-wuqKAQHFmR9YY68_vikuak4tSAWhCMPf&s", "thumbnailWidth": 193, "thumbnailHeight": 262, "contentUrl": "https://simple.wikipedia.org/wiki/Alphonse_Mucha" }, { "query": "Alfons Mucha", "origin": "www.europosters.eu", "title": "Fine Art Print Moet & Chandon (Vintage Art Nouveau) - Alfons Mucha", "imageUrl": "https://storage.googleapis.com/pod_public/1300/128482.jpg", "imageWidth": 975, "imageHeight": 1300, "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTEyU6CbBP7P9c_8YDpDMdo_q_Vvdwv8eQ6taJmTbeaWhzh0QL6&s", "thumbnailWidth": 194, "thumbnailHeight": 259, "contentUrl": "https://www.europosters.eu/art-photo/moet-chandon-vintage-art-nouveau-alfons-mucha-v90599" }, { "query": "Alfons Mucha", "origin": "www.mucha.cz", "title": "Biography - Mucha Museum E-shop", "imageUrl": "https://www.mucha.cz/en/image/catalog/biography/alfons-mucha-loc-3c05828u.jpg", "imageWidth": 2877, "imageHeight": 3574, "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSNMsNKi6AeGHT4IVvA-ZjWkRHJ097t1Ohedme4k5cDoGiGyPU&s", "thumbnailWidth": 201, "thumbnailHeight": 250, "contentUrl": "https://www.mucha.cz/en/biography" }, { "query": "Alfons Mucha", "origin": "rueroyalefinearts.com", "title": "Spring 1900, Alphonse Mucha", "imageUrl": "https://rueroyalefinearts.com/wp-content/uploads/Mucha-edited-8.jpg", "imageWidth": 2326, "imageHeight": 4722, "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTxaSjbx1cD1ofbqXDkQ05WUs1MeOk6pWaoytZDbx6p0JBi9Xw&s", "thumbnailWidth": 157, "thumbnailHeight": 320, "contentUrl": "https://rueroyalefinearts.com/shop/art-nouveau/alphonse-mucha/spring-1900-by-alphonse-mucha/" }, { "query": "Alfons Mucha", "origin": "learn.ncartmuseum.org", "title": "Alphonse Mucha: Art Nouveau Visionary – NCMALearn", "imageUrl": "https://learn.ncartmuseum.org/wp-content/uploads/2021/07/L-114-Reverie-1897-769x1024.jpg", "imageWidth": 769, "imageHeight": 1024, "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSTGSDQqiWMn865wOdmPu3cAExRVMDPwB_oLaEOXAW21TOXqD8&s", "thumbnailWidth": 194, "thumbnailHeight": 259, "contentUrl": "https://learn.ncartmuseum.org/resources/alphonse-mucha-art-nouveau-visionary/" } ... ``` ### πŸ—Ύ What are other tools for scraping Google? If you need to scrape data from other Google apps and services, you can try these tools:
πŸ”Β Google Search Scraper πŸ“ Google Maps Extractor
πŸ“‰Β Google Trending Searches πŸ“ˆ Google Trends Scraper
πŸŽ“ Google Scholar Scraper 🀟 Google Datasets Translator
πŸ“© Google Maps Email Extractor πŸ‘ Google Lens Actor
### ❓FAQ #### Is there an official Google Image Search API? No, Google does not provide a dedicated API to get images from Google. Since there isn't an official Google Image Search API to extract data from Google image results, people use other ways like web scraping or open-source APIs. Much like the API, web scraping tools like [Google Images Scraper](https://apify.com/hooli/google-images-scraper) can visit the Google Images website, conduct a search, and extract image information from the pages they find. #### I don't want just image URLs. Can I download images from URLs? Yes. After you've scraped Google Image search results, you can find the image URLs in your storage. If you want to extract image files from those URLs, use **[Download Images From Dataset](https://apify.com/zuzka/download-images-from-dataset) πŸ”—**Β Actor. It will download the scraped images in bulk by exporting the image URLs into a ZIP folder. #### Can I use this Google Image Search API to do reverse image search? Google Images Scraper is not the best image scraping tool for this. πŸ‘ **[Google Lens](https://apify.com/alexey/google-lens)** might fit your bill better. #### Can I integrate Google Images Scraper with other apps? Yes. This Google Image Search API can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, LangChain and more. Or you can use webhooks to carry out an action whenever an event occurs, e.g. get a notification whenever Google Images Scraper successfully finishes a run. #### Can I use Google Images Scraper as its own API? Yes, you can use the Apify API to access Google Images Scraper programmatically. The API allows you to manage, schedule, and run Apify [Actors](https://apify.com/actors), access datasets, monitor performance, get results, create and update Actor versions, and more. To access the API using Node.js, you can use the `apify-client` [NPM package](https://apify.com/hooli/google-images-scraper/api/client/nodejs). To access the API using Python, you can use the `apify-client` [PyPI package](https://apify.com/hooli/google-images-scraper/api/client/python). For detailed information and code examples, refer to the [Apify API documentation](https://docs.apify.com/api/v2). #### Can I use this Google Images Scraper in Python? Yes, you can use the Apify API with Python. To access the [Google Images API with Python](https://apify.com/hooli/google-images-scraper/api/client/python), use the `apify-client` PyPI package. You can find more details about the client in our [Python Client documentation](https://docs.apify.com/api/client/python/). #### Not your cup of tea? Build your own Google Images scraper. Google Images Scraper doesn’t exactly do what you need? You can always build one of your own! We have various [web scraping templates](https://apify.com/templates) in Python, JavaScript, and TypeScript to get you started. Alternatively, you can write it from scratch using our [open-source library Crawlee](https://crawlee.dev/). You can keep the scraper to yourself or make it public by adding it to Apify Store (and [find users](https://apify.com/partners/actor-developers) for it). #### Your feedback We’re always working on improving the performance of our [Actors](https://apify.com/actors). So if you’ve got any technical feedback for Google Images Scraper or simply found a bug, please create an issue on the Actor’sΒ [Issues tab](https://console.apify.com/actors/tnudF2IxzORPhg4r8/console/)Β in Apify Console. # Actor input Schema ## `queries` (type: `array`): The queries of searches you want to get the data from. ## `maxResultsPerQuery` (type: `integer`): The maximum amount of results to result per every query. ## Actor input object example ```json { "queries": [ "best CRM tools", "apify blog" ], "maxResultsPerQuery": 100 } ``` # Actor output Schema ## `dataset` (type: `string`): Default dataset containing the scraped image results. Each item has the following fields: query (the search query), origin (source page URL), title, imageUrl, imageWidth, imageHeight, thumbnailUrl, thumbnailWidth, thumbnailHeight, contentUrl. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "apify" ] }; // Run the Actor and wait for it to finish const run = await client.actor("hooli/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["apify"] } # Run the Actor and wait for it to finish run = client.actor("hooli/google-images-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": [ "apify" ] }' | apify call hooli/google-images-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=hooli/google-images-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Images Scraper", "description": "Scrape image details from images.google.com. Add your query and number of images and extract image details such as image URL, image source, description, image dimensions, thumbnail, and more. Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.", "version": "0.0", "x-build-id": "rUtAzWVSW6rwXl5TP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hooli~google-images-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hooli-google-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/hooli~google-images-scraper/runs": { "post": { "operationId": "runs-sync-hooli-google-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/hooli~google-images-scraper/run-sync": { "post": { "operationId": "run-sync-hooli-google-images-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "queries": { "title": "Searches to go through", "type": "array", "description": "The queries of searches you want to get the data from.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max results per query", "type": "integer", "description": "The maximum amount of results to result per every query.", "default": 300 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```