# Google Shopping Seller Data (`hunt_api/google-shopping-seller-data`) Actor

One Google Shopping seller-offer report for a Google product ID and location. Export structured results or connect through the Apify API.

- **URL**: https://apify.com/hunt_api/google-shopping-seller-data.md
- **Developed by:** [HuntAPI](https://apify.com/hunt_api) (community)
- **Categories:** Business
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.50 / 1,000 successful sellers result objects

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

### Google Shopping Seller Data: what does it do?

One Google Shopping seller-offer report for a Google product ID and location.

Get **structured results** in your Apify dataset, ready to use in spreadsheets, reports or another application. Run it from the input form or connect it to an automated workflow through the Apify API. **You do not need a supplier account or supplier API key.**

### ✨ What can you use it for?

- 🔎 **Research:** collect the available data for your chosen queries, identifiers or URLs.
- 📈 **Monitoring:** schedule runs in Apify to collect fresh observations over time.
- 🔌 **Automation:** retrieve results through the API and connect them to your existing tools.
- 📥 **Export:** download the dataset in JSON, CSV or other formats offered by Apify.

### 📊 What data can you get?

| Data | What you receive |
| --- | --- |
| 🏪 **Seller offers** | Offers returned for the supplied Google product ID |
| 💰 **Offer pricing** | Prices and currencies when available |
| 🔗 **Offer metadata** | Returned seller and offer details |

Optional fields depend on the individual result and may be empty. Each dataset row contains one delivered record or report; the returned information is inside `data`.

#### Available operations

- **Sellers**

Choose one operation per run. Availability depends on the enabled operation shown in the input form.

### 🚀 How to use Google Shopping Seller Data

1. Enter your query, identifier or URL in the **Input** form.
2. Choose the available location, language and result limits relevant to your request.
3. Click **Start** and wait for the run to finish.
4. Open **Dataset** to inspect your results or download them.

The run defaults are configured for you. Fresh-data runs require an eligible paid Apify plan.

#### Example input

```json
{
  "operation": "sellers",
  "parameters": {
    "product_id": "16738353524837394214",
    "location_code": 2840,
    "language_code": "en",
    "location_name": "United States",
    "priority": 1
  }
}
```

Choose sellers. Use parameters for one native request or requests for a batch of up to 50. One Google Shopping seller-offer report for a Google product ID and location. Returned offers remain inside one report and are charged once. EAN lookup, product reviews and further pages are excluded. Queued tasks can be retrieved with the returned existingTaskId; omit parameters and requests when resuming. No supplier account is required for customers.

### 💰 How much does it cost?

**Usage only: $0 fixed monthly charge and no Actor-start fee.** The Pricing tab shows the current rates for your Apify plan. Only successfully delivered output events are charged; empty output, errors and duplicates are not successful outputs.

| Charged event | Unit | From / 1,000 events |
| --- | --- | --- |
| successful-sellers | sellers result object | $10.5 |

One delivered record or report is charged according to its listed event. Nested fields inside a report are not separate events. This release has no separately charged platform usage.

### 📦 Results and automation

Results appear in the default dataset. Use Apify’s export controls or retrieve the dataset through its API. For automation, start a run with your Apify token, wait for completion, then read the returned dataset ID.

The **run report** in key-value storage explains incomplete requests and errors. Queue-based requests may take time to finish.

### ❓ Frequently asked questions

#### Do I need an external API key?

No. Supplier access is provided by this Actor. You only need your Apify account, and your Apify token if you run it through the API.

#### Does it return every possible field?

One Google Shopping seller-offer report for a Google product ID and location. Returned offers remain inside one report and are charged once. EAN lookup, product reviews and further pages are excluded.

#### Why did I receive fewer results than requested?

A result limit is a maximum, not a guarantee. Availability varies by query, location and website. Read the run report for incomplete work or errors. Only delivered successful output events are charged.

### 💬 Support

Open an issue on this Actor with the **run ID**, the operation you selected, and the result you expected. Include a redacted example input when useful. Never share passwords or API keys. This Actor is not affiliated with the websites it retrieves data from.

# Actor input Schema

## `operation` (type: `string`):

Exactly one operation per run. Availability and source checks are enforced by the owner configuration.

## `parameters` (type: `object`):

Native fields for the selected operation. See its parameter table and example in the instructions. Supplier credentials never belong here.

## `requests` (type: `array`):

Use this instead of parameters to queue up to 50 native requests. Each item gets its own budget reservation.

## `crawl` (type: `object`):

For crawl reports only: parameters with target and max_crawl_pages, or an owned existingTaskId.

## `existingTaskId` (type: `string`):

Uses the saved task input and budget. Leave parameters and requests unset when resuming.

## `execution` (type: `object`):

Set positive maxRequests and maxProviderCostUsd after the source is verified. Polling calls count toward the request allowance. Pagination and detail expansion require reviewed contracts.

## Actor input object example

```json
{
  "operation": "sellers",
  "execution": {
    "maxRequests": 45,
    "maxProviderCostUsd": 0.001,
    "maxResults": 1,
    "maxPages": 1,
    "maxEnrichments": 0,
    "autoPaginate": false,
    "outputMode": "result_objects",
    "pollDeadlineSeconds": 185,
    "requestTimeoutSeconds": 60
  }
}
```

# Actor output Schema

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

No description

## `report` (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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("hunt_api/google-shopping-seller-data").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("hunt_api/google-shopping-seller-data").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 '{}' |
apify call hunt_api/google-shopping-seller-data --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hunt_api/google-shopping-seller-data"
        }
    }
}
```

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/hnbtcsTaC4VlNq1Pt/builds/yfbYIzEV9a83zj2fl/openapi.json