# Google Shopping Scraper (`searchapi/google-shopping-scraper`) Actor

Scrapes Google Shopping for any query. Extracts title, product/offer ID, merchant, price, original price, discount, shipping, condition, availability, ratings, reviews, thumbnail, brand, category, variants, and more.

- **URL**: https://apify.com/searchapi/google-shopping-scraper.md
- **Developed by:** [Search API](https://apify.com/searchapi) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Features:** Limited permissions
- **Stats:** 12 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 search results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Shopping Scraper

### What is this tool?

Google Shopping Scraper helps you collect shopping data from Google (the world's most popular search engine). Search for any product and gather prices, merchants, ratings, reviews, and product details from multiple stores in one place.

### What can you use it for?

- Compare product prices across multiple stores
- Find the best deals and discounts
- Track product prices over time
- Research products before buying

### What data do you get?

Each result uses a stable, typed contract with up to **59 documented fields**. Fields Google does not expose for a particular card are omitted instead of being filled with placeholders. The discount percentage uses Google's visible sale badge when available and falls back to the displayed prices otherwise.

**Identity** (6 fields): Type, Result Type, Position, Page, Product ID, Offer ID

**URLs** (7 fields): Product URL, Link (alias), Merchant Domain, Merchant URL, Seller URL, Image URL, Search URL

**Text** (2 fields): Title, Title (HTML)

**Media** (2 fields): Thumbnail, Additional Images

**Pricing** (7 fields): Price, Price (numeric), Currency, Original Price, Original Price (numeric), Discount, Discount %

**Ratings** (5 fields): Merchant Rating, Merchant Rating Count, Rating, Rating Count, Review Count

**Location** (1 fields): Country

**Dates & Duration** (1 fields): Delivery Date

**Categorization** (2 fields): Category, Tags

**Source** (3 fields): Merchant, Seller, Merchant Logo

**Search Context** (5 fields): Search Metadata, Query, Query (alias), Market, Language

**Other** (15 fields): Shipping, Delivery, Delivery Date, Tax, Condition, Availability, Brand, Variants, Specifications, Ad, Sponsored, Free Shipping, On Sale, In Stock, Scraped At

### How to use it

#### Step 1: Enter your search

Type in your search term, like "laptop".

#### Step 2: Set your preferences

Adjust the options below to customize your search.

#### Step 3: Run the tool

Click the run button and wait for your results. The tool will gather all the data and save it in a clean, organized format.

### Input options

| Option | What it means | Required | Default |
|--------|---------------|----------|---------|
| **Search Query** | The search query to use on Google Shopping. | Yes | laptop |
| **Additional Queries** | Optional list of searches. The global item limit is split fairly across unique queries. | No | \[] |
| **Max Items** | Max product results to scrape. | No | 50 |
| **Max Pages** | Maximum Google Shopping result pages fetched per query. | No | 2 |
| **Country Code** | Google country code (e.g. 'us', 'uk', 'in', 'de'). | No | us |
| **Language Code** | Google language code (e.g. 'en', 'hi', 'de', 'fr'). | No | en |
| **Minimum Price** | Filter results by minimum price (in local currency). | No | — |
| **Maximum Price** | Filter results by maximum price (in local currency). | No | — |
| **Proxy Configuration** | `GOOGLE_SERP` is recommended in Apify Cloud. Direct/Residential mode uses Playwright with stable session fingerprints. | No | GOOGLE_SERP |

The complete input schema, including field types, defaults, filters, and bounds, is in [`.actor/input_schema.json`](.actor/input_schema.json).

### Running locally and in Apify Cloud

```text
apify run --purge --input-file INPUT.json
apify push
apify call <actor-id> --input-file INPUT.json
```

Google SERP Proxy is HTTP-only, so the Actor sends its Shopping request through the scoped proxy URL rather than trying to tunnel Playwright through it. Local external proxy access depends on the Apify account configuration; cloud runs are the authoritative validation when that feature is unavailable locally.

Explicit CAPTCHA or unusual-traffic pages are never parsed, stored, or repeatedly retried. Product URLs are included when Google exposes a public product or merchant target; otherwise the optional URL fields are omitted and identity uses the public card metadata plus stable visible fields.

### Output

Your results come in a clean, organized table with **two views**:

#### Overview view

Shows the most important fields at a glance:

- **Position**
- **Title**
- **Merchant**
- **Price**
- **Rating**
- **Rating Count**
- **Thumbnail**
- **Query**
- **Scraped At**

#### Full details view

Shows all documented fields in detail. See "What data do you get?" above for the complete list.

The complete dataset field schema is in [`.actor/dataset_schema.json`](.actor/dataset_schema.json).

### Tips for best results

✅ **Be specific** with your search terms for more relevant results

✅ **Try different variations** of your search term to discover more results

✅ **Browse multiple pages** of results to get a wider variety

### Frequently asked questions

**Why use Google?**
Google is the world's most popular search engine, handling over 8 billion searches per day. It has the largest index of web pages and provides the most comprehensive search results.

**How do I get the results?**
Your results are saved in your Apify dashboard. You can download them in various formats (JSON, CSV, Excel) or access them via the API.

**Can I run it on a schedule?**
Yes! Apify supports scheduled runs. You can set up the tool to run automatically at any interval (hourly, daily, weekly, etc.) from your dashboard.

**What if I get fewer results than I asked for?**
This can happen if the search engine doesn't have enough matching results for your search, or if some results are blocked. Try different keywords or relax your filters.

**Need more help?**
If you have questions or run into issues, our support team is ready to help. Just reach out through the Apify platform and we'll get back to you quickly.

# Changelog

This Actor's version history is a separate document: https://apify.com/searchapi/google-shopping-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

The search query to use on Google Shopping.

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

Optional additional product searches. Records are divided fairly across unique queries.

## `maxItems` (type: `integer`):

Maximum number of product results to scrape.

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

Maximum Shopping result pages fetched for each query.

## `maxConcurrency` (type: `integer`):

Used by direct and Residential browser mode; GOOGLE_SERP pages use fast sequential HTTP requests.

## `maxRequestRetries` (type: `integer`):

Temporary failures only. Explicit CAPTCHA pages are not retried.

## `navigationTimeoutSecs` (type: `integer`):

Maximum seconds for one HTTP request or browser navigation.

## `requestHandlerTimeoutSecs` (type: `integer`):

Maximum seconds for a browser request handler.

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

Google country code (e.g. 'us', 'uk', 'in', 'de').

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

Google language code (e.g. 'en', 'hi', 'de', 'fr').

## `minPrice` (type: `integer`):

Filter results by minimum price (in local currency).

## `maxPrice` (type: `integer`):

Filter results by maximum price (in local currency).

## `enrichProductDetails` (type: `boolean`):

Fetch each product's own Google Shopping viewer to add the merchant destination, the product image, availability, shipping and the attribute list. Grid fields are kept when the detail page is unavailable.

## `proxyConfiguration` (type: `object`):

Proxy configuration for the scraper.

## Actor input object example

```json
{
  "query": "laptop",
  "queries": [],
  "maxItems": 50,
  "maxPages": 2,
  "maxConcurrency": 1,
  "maxRequestRetries": 1,
  "navigationTimeoutSecs": 45,
  "requestHandlerTimeoutSecs": 90,
  "gl": "us",
  "hl": "en",
  "enrichProductDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ]
  }
}
```

# 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 = {
    "query": "laptop",
    "queries": [],
    "maxItems": 50,
    "maxPages": 2,
    "maxConcurrency": 1,
    "maxRequestRetries": 1,
    "navigationTimeoutSecs": 45,
    "requestHandlerTimeoutSecs": 90,
    "gl": "us",
    "hl": "en",
    "enrichProductDetails": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "GOOGLE_SERP"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("searchapi/google-shopping-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 = {
    "query": "laptop",
    "queries": [],
    "maxItems": 50,
    "maxPages": 2,
    "maxConcurrency": 1,
    "maxRequestRetries": 1,
    "navigationTimeoutSecs": 45,
    "requestHandlerTimeoutSecs": 90,
    "gl": "us",
    "hl": "en",
    "enrichProductDetails": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["GOOGLE_SERP"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("searchapi/google-shopping-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 '{
  "query": "laptop",
  "queries": [],
  "maxItems": 50,
  "maxPages": 2,
  "maxConcurrency": 1,
  "maxRequestRetries": 1,
  "navigationTimeoutSecs": 45,
  "requestHandlerTimeoutSecs": 90,
  "gl": "us",
  "hl": "en",
  "enrichProductDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "GOOGLE_SERP"
    ]
  }
}' |
apify call searchapi/google-shopping-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,searchapi/google-shopping-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/jT4xmfErw1dwE4xmx/builds/cvdH7Ecz0MbamV09V/openapi.json