🖼️ Google Images Search Scraper

One query record contains the complete returned result list

For content research, search analysis and repeatable exports

🔎 What is the Google Images Search Scraper — and when should you use it?

The Google Images Search Scraper turns complete first-page Google Images results for one query into clean, structured rows you can filter, export and feed straight into a spreadsheet, database or AI agent. No account, no portal API key, no browser automation to maintain.

Use it when you need: you need ranked image titles, links and available media metadata in a complete query record.

Use something else when: you need ordinary web pages instead of media results. Use Google Search Scraper for organic web page results. This actor returns search metadata; it does not download media, verify rights or extract transcripts.

🤖 Use with AI agents

Already connected to the Apify MCP server? Just ask for this Actor by name: sian.agency/google-image-search-scraper

Agentic payments: Availability of x402 and Skyfire depends on this Actor's current Store eligibility. Check the published listing for supported payment methods. One completed search is billed once, including a valid zero-match list. Failed retrievals have no search-event charge. A separate run-start fee applies.

Otherwise copy this prompt into Claude, ChatGPT, Cursor or any MCP-enabled assistant:

I want a complete Google Images result list for my query using the Apify Actor `sian.agency/google-image-search-scraper`.

Use it when I need: you need ranked image titles, links and available media metadata in a complete query record.

Don't use it when: you need ordinary web pages instead of media results — use google-serp-scraper instead.

How to call it: set operation to search and supply one query. Read the complete nested result list in the returned record.

Start with this input:
{
  "operation": "search",
  "query": "beach"
}

Ask me which search phrase to use, then run the Actor and summarise the results as a table.

Things you can ask your agent for:

• Research public media results for this topic.
• Compare two topic phrases in separate runs.
• Export the complete returned list as JSON.

Machine-readable API, MCP config and OpenAPI definition for this Actor are published at apify.com/sian.agency/google-image-search-scraper.md.

📋 Overview

Search Google Images for one phrase and save the returned first-page results in a structured record. Review titles and links, then inspect the available media metadata.

Each completed query is billed once. A valid empty list is a completed search observation and is also billed once. Retrieval failures have no search-event charge; a separate run-start fee applies.

✨ Features

• 🔎 Query search: Supply the phrase you want to research.
• 📚 Complete returned list: Every result from this search response remains in one nested array.
• 🔗 Source links: Review the linked pages before using the content.
• 📝 Available metadata: Image IDs, titles, image links, dimensions, available size text, thumbnail fields, source site, source-page link, position and rank.
• 📊 Readable preview: Result counts and the first title are visible without opening the array.
• 📄 Processing report: See completed work, accepted charges and retry advice.
• 🤖 Automation: Export JSON or use the actor in your existing workflow.

🎬 Quick Start

Open the input form, review the example query and press Start. Open the dataset after the run finishes. The complete list is in the images field.

{
  "operation": "search",
  "query": "beach"
}

🚀 Getting Started

Step 1: Choose a query

Use a product name, topic or phrase. One run performs one query.

Step 2: Run the search

Review the run's maximum charge before starting. Results and rankings can change between runs.

Step 3: Review and export

Check the first-result preview, then export JSON to retain the nested list. CSV and Excel exports may store nested arrays as JSON text.

📥 Input Configuration

Field	Type	Required	Description
operation	string	No	Search; the only supported operation.
query	string	Yes	A nonblank phrase from 1 to 500 characters.

The Console example is a prefill. API callers must supply their own query; an empty input does not invent work.

This version uses the first page with the default search context. It does not offer date, region or content filters.

📤 Output

One dataset record represents one completed query.

Field	Type	Description
previewImageUrl	string or null	Available first-result preview image URL, or null when unavailable.
query	string	The phrase used for this search.
resultCount	integer	Number of results included in the complete returned list.
images	array	Complete returned image results, preserving the original fields and values.
topResultTitle	string or null	First result title, or null when no result is available.
topResultUrl	string or null	First result content or source-page link, or null when unavailable.
errorMessage	string or null	Retry advice for a retrieval failure; null for completed searches.
_operation	string	The search operation used for this record.
_fetchedAt	string	UTC time when this search record was retrieved.
complete	boolean	True for a validated completed response, including a valid empty result list.
processedAt	string	UTC time when this record was prepared.
scrapingDate	string	UTC observation timestamp for this search.
status	string	success for a completed search, or error for a retrieval failure.

Image IDs, titles, image links, dimensions, available size text, thumbnail fields, source site, source-page link, position and rank.

{
  "query": "beach",
  "resultCount": 10,
  "images": [{"title": "Example result; actual values vary"}],
  "complete": true,
  "status": "success"
}

The abbreviated example illustrates the envelope. Real result fields remain in the nested array. Missing metadata is not inferred. Image URLs do not guarantee downloadable full-resolution originals or reuse rights.

💼 Use Cases & Examples

1. Compare search visibility

SEO analysts: Inspect ranked image results for a product or topic.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

2. Build a reference list

Content editors: Collect public image titles and links before editorial review.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

3. Research branded queries

Brand teams: Review the result list for a brand phrase.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

4. Compare competitor topics

Market researchers: Run separate queries and compare the observed result lists.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

5. Create a search evidence record

AI workflow builders: Store the complete search observation as JSON.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

6. Prepare a client search report

Agency analysts: Share links and available metadata with a retrieval timestamp.

Input: A topic or brand phrase. Output: One complete search observation. Use: Review and compare the linked public results.

🔗 Integration Examples

JavaScript

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('sian.agency/google-image-search-scraper').call({"operation": "search", "query": "beach"});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0].images);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('sian.agency/google-image-search-scraper').call(run_input={"operation": "search", "query": "beach"})
for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item['images'])

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~google-image-search-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"operation": "search", "query": "beach"}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger the workflow on a schedule or a research request.
2. Send the query to this actor using an HTTP Request step.
3. Read the complete result record from the dataset.
4. Save the JSON to your database or send selected links for review.

📈 Performance & Pricing

Apify plan	Completed search	Run start
Free	$0.57144	$0.020
Bronze	$0.14286	$0.005
Silver	$0.13429	$0.005
Gold	$0.12572	$0.005

One completed query includes every returned result. A valid empty search costs one search event. Retrieval failures have no search-event charge, but the platform run-start fee can still apply.

One query per run applies to all plans. Paid Apify plans receive the event discounts above. Enterprise users should check their live quote. View current pricing.

Processing time varies with the query and service availability. There is no guaranteed result count, ranking stability or exhaustive coverage.

❓ Frequently Asked Questions

What is billed?

One completed query record, including a valid zero-match search. A separate run-start fee applies. Failed retrievals have no completed-search event charge.

Are all results included?

Every item returned by this first-page search is preserved in the nested result array. Search coverage is not exhaustive.

Can I download media?

This actor returns links and available metadata. It does not download files or transfer copyright permissions.

Can I send an empty input?

API callers must supply a nonblank query. The Console supplies a visible example for testing.

Are filters available?

This focused version accepts the query only. It uses the default first-page search context.

How can I export the results?

Use the Apify dataset export. JSON retains nested result arrays; CSV can contain nested JSON values.

🐛 Troubleshooting

The query was rejected: Supply a nonblank phrase from 1 to 500 characters.

The completed result list is empty: Try a broader topic. A valid empty search is still billed once.

Search capacity is exhausted: Contact support before retrying. Repeated runs cannot bypass the service allowance.

Some media metadata is missing: Only fields available in the returned results are provided. This actor does not infer dates, rights or engagement metrics.

A media link no longer works: Open its source page. Linked content can move or be deleted after the search.

⚖️ Legal Disclaimer

Results may contain copyrighted material or personal data. Receiving a link does not grant permission to reuse the linked image or video. Check the publisher's terms and your legal basis before storing or republishing content.

Use the results lawfully and respect applicable privacy rules, including the GDPR where it applies. Apify discusses the legality of web scraping here.

Google is a trademark of Google LLC. This actor is independently provided by SIÁN Agency and is not affiliated with Google.

🤝 Support

Open an actor issue with your run link and query. You can also contact apify@sian-agency.online.

⭐ Leave a review to help us decide what to improve.

Built by SIÁN Agency · More tools