# Google Images API - Image Search Results in 90+ Countries (`tenfoldfleet/google-images-api`) Actor

Search Google Images by keyword and export the ranked results: direct image link, thumbnail, caption, the page using the image and its site, plus related searches. 1 to 200 images per keyword, 94 countries. About $1.93 per 1,000 images; failed keywords are free.

- **URL**: https://apify.com/tenfoldfleet/google-images-api.md
- **Developed by:** [Tenfold Fleet](https://apify.com/tenfoldfleet) (community)
- **Categories:** SEO tools, Agents, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 image results

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/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

Not affiliated with, endorsed by or sponsored by Google. "Google" and "Google Images" are trademarks of Google LLC.

### What does Google Images API do?

**Google Images API** turns any Google Images keyword search into clean rows of data. Type a keyword such as "modern kitchen design", pick a country, and you get every image result in rank order: the **full-size image URL**, a **thumbnail**, the **image title**, the **page the image appears on**, the **website name** and its **position** in the results. Up to **200 images per keyword**, up to 1,000 keywords per run, in any of 94 countries and their languages.

It works as an **image search API** for scripts, spreadsheets, no-code tools and AI agents: run it from the Apify Console, call it over the Apify API, or plug it into Make, Zapier or n8n. No browser, no Google account and no setup.

### Why use it?

- **SEO and image SEO:** see which sites and pages win the image results for your keywords, in every market you sell in.
- **Visual research and moodboards:** collect reference images for a design, product or campaign idea in seconds.
- **Dataset building:** gather image URLs and captions by keyword for labelling, classification or AI training sets.
- **Brand and product monitoring:** check where your product photos, logos or competitors' images show up on Google Images.
- **Content sourcing:** find the original page behind an image so you can credit it or ask for a licence.

### What data can it extract?

![Sample output of Google Images API, rows from a real run: Keyword, #, Preview, Title, Format, Website](https://api.apify.com/v2/key-value-stores/4TBgG7fopkYMNWnX2/records/google-images-api-output.png)

| Field | What it holds |
|---|---|
| `query` | The keyword you searched |
| `position` | Rank of the image in the results (1 = first) |
| `title` | Image title as shown by Google |
| `imageUrl` | Direct link to the full-size image file |
| `imageFormat` | jpg, png, webp, gif, svg ... when the URL shows it |
| `imageDomain` | Host that serves the image file |
| `thumbnailUrl` | Google's thumbnail of the image |
| `pageUrl` | Page the image appears on |
| `domain` | Website of that page |
| `sourceName` | Site name shown under the image |
| `altText` | Image caption text |
| `relatedSearches`, `relatedTopics` | Google's related searches and topic chips (on the first row of each keyword) |
| `searchUrl` | The Google Images search that produced the row |
| `country`, `scrapedAt` | Search country and time |

### How to search Google Images by keyword

1. Open the actor and add one or more keywords under **Search keywords**.
2. Set **Max images per keyword** (1 to 200).
3. Choose a **country** (name or code, such as "GB" or "Germany") and, if you want, a language code.
4. Click **Start**. Results usually arrive within a few seconds per keyword.
5. Download the images table as JSON, CSV or Excel, or read it from the API.

### How much does it cost?

Pay per result, no monthly fee:

- **$0.0019 per image** returned
- **$0.003 per results page** of up to 100 images (a keyword with 101 to 200 images is 2 pages)

That is about **$1.93 per 1,000 images** at 100 images per keyword. Keywords that fail, return no images or use unsupported operators are **free**, and duplicate images are not charged. The run stops at your maximum cost per run, and searches are sized so you never pay for images that cannot be delivered.

**Free Apify plan:** each run searches at most 3 keywords and returns at most 100 images. Any paid Apify plan unlocks up to 200 images per keyword and 1,000 keywords per run.

### Input

```json
{
    "queries": ["modern kitchen design", "golden retriever puppy"],
    "maxImagesPerQuery": 100,
    "country": "United States",
    "languageCode": "en"
}
```

### Output

One row per image. Download the dataset as JSON, CSV, Excel, XML or HTML.

```json
{
    "query": "modern kitchen design",
    "country": "United States",
    "position": 1,
    "title": "Contemporary Designer Kitchens | Contemporary Kitchen Design Centre",
    "imageUrl": "https://www.kitchendesigncentre.com/wp-content/uploads/2026/04/sunlit-elegance-a-kitchen-designed-to-inspire.jpg",
    "imageFormat": "jpg",
    "imageDomain": "kitchendesigncentre.com",
    "thumbnailUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcR4wdk2I6MqtLIaMYkB6HRhXYhLbCxE0hX-VjxzUkjWrQ&s=10",
    "pageUrl": "https://www.kitchendesigncentre.com/contemporary-modern-kitchens/",
    "domain": "kitchendesigncentre.com",
    "sourceName": "Kitchen Design Centre",
    "altText": "Contemporary Designer Kitchens | Contemporary Kitchen Design Centre",
    "relatedSearches": ["small house modern kitchen design", "new modern kitchen design"],
    "relatedTopics": ["Luxury", "Wood", "Interior", "Small", "L shape"],
    "searchUrl": "https://www.google.com/search?q=modern%20kitchen%20design&udm=2&hl=en&gl=US",
    "scrapedAt": "2026-11-07T03:53:55.000Z"
}
```

A keyword that could not be searched comes back as a free row with an `error` field that says why.

### Tips

- Results follow the country you choose: "pizza oven" in Italy and in the United States return different sites.
- Asking for 100 images costs the same page fee as asking for 20, so round up to 100 when you need more than a handful.
- Use plain keywords. Operators like `site:` or `filetype:` are rejected for free; put the site or file type into the words instead ("ikea kitchen", "kitchen png").
- Schedule the actor to track how image rankings for your keywords change over time.

### FAQ

#### Does Google offer an API for image search results?

Google has no public API that returns the Google Images results people see on google.com. This actor returns those results as structured data you can call over the Apify API.

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

Up to 200, which is as deep as Google Images results go for this actor. For more images, add related keywords.

#### Can I download the image files?

The output has direct image URLs. Pass them to a downloader or your own script; this actor does not store image files.

#### Can AI agents use it?

Yes. It works with the Apify MCP server and API, so an agent can ask for "images of X in country Y" and get a table back.

#### Is scraping Google Images legal?

The actor collects publicly visible search results. Images themselves are usually copyrighted by their owners: check the source page and licence before you reuse an image.

### Disclaimer

This actor returns publicly available Google Images search results. You are responsible for how you use the data and for respecting the copyright and licence of every image. Need help or a new field? Open an issue on the actor's [Issues tab](https://apify.com/tenfoldfleet/google-images-api/issues).

### More tools from Tenfold Fleet

| Actor | Output |
|---|---|
| [Google AI Overviews Checker - Citations & Domain Tracker](https://apify.com/tenfoldfleet/google-ai-overviews-checker) | keyword checked |
| [Google Keyword Planner Alternative - Ideas, Bids & Volume](https://apify.com/tenfoldfleet/google-keyword-planner) | keyword idea |
| [Google Maps Rank Tracker - Geo-Grid Rank Changes & Competitors](https://apify.com/tenfoldfleet/google-maps-rank-tracker) | grid point checked |
| [Google Trends Scraper - Search Interest by Region and Over Time](https://apify.com/tenfoldfleet/google-trends-scraper) | keyword |
| [Google Ads Transparency Center Scraper - Competitor Ads by Site](https://apify.com/tenfoldfleet/google-ads-transparency-scraper) | ad |
| [Google Flights API & Scraper - Fares by Route and Date](https://apify.com/tenfoldfleet/google-flights-scraper) | route search |
| [Google Hotels Scraper - Nightly Prices, Stars & Booking Sites](https://apify.com/tenfoldfleet/google-hotels-scraper) | hotel |
| [Google for Jobs Scraper - Openings by City, Pay & Job Board](https://apify.com/tenfoldfleet/google-jobs-scraper) | job listing |
| [Google Maps Extractor - Business Leads, Phones & Websites](https://apify.com/tenfoldfleet/google-maps-extractor) | place |
| [Google News Scraper - Articles, Real URLs & Full Text](https://apify.com/tenfoldfleet/google-news-scraper) | article |
| [Google Travel Hotel Rate Tracker - OTA Prices for Every Night](https://apify.com/tenfoldfleet/google-travel-hotel-rate-tracker) | offer |
| [ASO Keyword Rank Tracker: iOS & Android App Positions](https://apify.com/tenfoldfleet/aso-keyword-rank-tracker-app-store-google-play) | keyword check |

All 122 tools: [apify.com/tenfoldfleet](https://apify.com/tenfoldfleet). If this Actor saves you time, save it (the bookmark on its Store page) and leave a review: both help other people find it. Found a bug or need another field? Tell us on the Issues tab of this page.

# Changelog

This Actor's version history is a separate document: https://apify.com/tenfoldfleet/google-images-api/changelog.md

# Actor input Schema

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

What you would type into Google Images, one keyword per line, e.g. "modern kitchen design" or "golden retriever puppy". Each keyword is one search. Search operators (site:, inurl:, intitle:, filetype:) are not supported and such keywords are skipped free of charge. Up to 1,000 keywords per run.

## `maxImagesPerQuery` (type: `integer`):

Most images to return for each keyword (Google Images gives up to 200). Images are billed per image plus one small page fee per 100 images. Free Apify plan: at most 3 keywords and 100 images per run.

## `country` (type: `string`):

Which country's Google Images results to get: a country name or two-letter code, e.g. "United States", "GB", "Germany", "IN". Empty = United States.

## `languageCode` (type: `string`):

Optional Google interface language code, e.g. "en", "de", "es". Empty = the main language of the country.

## Actor input object example

```json
{
  "queries": [
    "modern kitchen design"
  ],
  "maxImagesPerQuery": 20,
  "country": "United States"
}
```

# Actor output Schema

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

No description

# 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": [
        "modern kitchen design"
    ],
    "maxImagesPerQuery": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("tenfoldfleet/google-images-api").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": ["modern kitchen design"],
    "maxImagesPerQuery": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("tenfoldfleet/google-images-api").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": [
    "modern kitchen design"
  ],
  "maxImagesPerQuery": 20
}' |
apify call tenfoldfleet/google-images-api --silent --output-dataset

```

## MCP server setup

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

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/Ba6gQSu5y9fWSM3Ul/builds/GYssND40bxhjMSN1O/openapi.json
