# Track Headphone Prices and Sellers on Google Shopping

**Use case:** 

Request US Google Shopping offers for Sony WH-1000XM5. The first run returns observed offers; later runs of the same saved task compare prices and newly observed offers. Unresolved incompatible currencies fail the query and preserve its baseline. Scheduling is optional.

## Input

```json
{
  "queries": [
    "Sony WH-1000XM5"
  ],
  "countryCode": "us",
  "languageCode": "en",
  "initialRun": "emitCurrent",
  "maxOffersPerQuery": 10,
  "includeSellers": [],
  "excludeSellers": [],
  "resetState": false
}
```

## Output

```json
{
  "eventType": {
    "label": "Event",
    "format": "string"
  },
  "query": {
    "label": "Query",
    "format": "string"
  },
  "productTitle": {
    "label": "Product title",
    "format": "string"
  },
  "sellerName": {
    "label": "Seller name",
    "format": "string"
  },
  "priceText": {
    "label": "Price text",
    "format": "string"
  },
  "previousPriceText": {
    "label": "Previous price text",
    "format": "string"
  },
  "currency": {
    "label": "Currency",
    "format": "string"
  },
  "productUrl": {
    "label": "Public offer",
    "format": "string"
  },
  "observedAt": {
    "label": "Observed",
    "format": "string"
  }
}
```

## How it works

### 1. Sign up on Apify or log in

The Google Shopping Price Tracker & Seller Monitor Actor is ready to run with the inputs already set for "Track Headphone Prices and Sellers on Google Shopping". [Sign up or log in](https://console.apify.com/create-task-from-example/GhzLRRJV4NBCI8sXZ) and you'll land in Apify Console with a copy of this exact task.

### 2. Start the "Track Headphone Prices and Sellers on Google Shopping" task

The Google Shopping Price Tracker & Seller Monitor Actor will start running based on the input automatically. You can also change all the input fields, like product queries, country, and more, to match your specific use case.

### 3. Receive the "Track Headphone Prices and Sellers on Google Shopping" output

Monitor the progress in real time. You will be notified as soon as your dataset is complete and ready for review. Each result includes data such as event, query, product title, and more.

### 4. Integrate into your workflow

The final output is delivered in JSON, CSV, or Excel format, ready to be plugged into your workflow. You can also [run the "Track Headphone Prices and Sellers on Google Shopping" task via API](https://apify.com/monkey.d.scraping/google-shopping-price-change-seller-monitor.md).

## FAQ

### How do I compare the first and second run?

Save your own copy of the headphone-price task. The first run establishes its baseline and returns current offers. Run that same task again with resetState false to compare comparable offers.

### What does a new offer mean?

An offer is labelled new when it was not in this task’s baseline, so you see every offer that appeared since your last check.

### Why might the dataset be empty?

The headphone-price task can return no events when offers are unchanged. Inspect SUMMARY: a failed or degraded check means uncertainty, not proof that prices stayed the same or that sellers disappeared.

### What does a check cost and is it scheduled automatically?

At current rates, one healthy query plus one start costs $0.00905 at 512 MB, even with no changes. Failed or degraded queries have no query fee. The saved cap is $0.02. No schedule is created; consult the Pricing tab.

### Are direct offer links always included?

The headphone-price task includes public offer URLs when the source exposes them. URLs can be missing even when prices and sellers are available; inspect SUMMARY URL coverage before building a click-through workflow.

### Can Google return a different market?

Wrong currencies get one retry if the two-request budget allows. If still invalid, no query fee or baseline update. Recovery adds no query fee; the Actor-start fee still applies.

### Does opening this example start a paid run?

Opening this example creates an editable task copy. Review Run options and the spending cap, then choose Start or Save & start to run. No schedule is included. Actor charges apply when run; Try for free is the platform button label.

## About this Actor

This example demonstrates how to use [Google Shopping Price Tracker & Seller Monitor](https://apify.com/monkey.d.scraping/google-shopping-price-change-seller-monitor.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/monkey.d.scraping/google-shopping-price-change-seller-monitor.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/monkey.d.scraping/google-shopping-price-change-seller-monitor.md

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`).
