---
title: "Compare Shopping Prices"
method: POST
path: "/v1/tools/shopping_prices"
---

# Compare Shopping Prices

`POST /v1/tools/shopping_prices`

## Request

- Base URL: `https://unstuckapi.com`
- URL: `https://unstuckapi.com/v1/tools/shopping_prices`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Compare what stores charge for a product right now. Returns the Google Shopping listings with price, currency, seller and link. Listings are as Google shows them and can include used, refurbished, rental and bundle offers, so check the title and seller before treating a price as the going rate. Use it to check competitor pricing or find the going rate before buying or listing something.

Price: $0.25 per call. Charged once per call that returns a result, including an empty result list. Failed calls are free.

## Request body

- object
  - `product` string, required: The product to price, e.g. "sony wh-1000xm5".
  - `location` string: Country or place, e.g. "United States". Default "United States" (or the connection's default location).

## Response `200`

Success

- object
  - `tool` 'shopping_prices', required
  - `result` object, required
    - `product` string, required
    - `location` string, required: Location the prices are for.
    - `results` object[], required
      - `title` string, required
      - `price` number, required
      - `currency` string, nullable, required
      - `seller` string, nullable, required
      - `product_id` string, nullable, required: Google Shopping product id, if Google gave one.
      - `shopping_url` string, required: Link to open this listing on Google Shopping (see link_type).
      - `link_type` 'google_shopping_product' | 'google_shopping_search', required: google_shopping_product = the product's own Google Shopping page; google_shopping_search = a Google Shopping search for this exact title (no direct link was available).
  - `charged_usd` number, required
  - `balance_usd` number, required

## Other responses

- `400`: Invalid JSON or input. Not charged.
- `401`: Paid tool without a valid API key.
- `402`: Balance too low for this call. Not charged.
- `404`: Unknown tool.
- `422`: The tool failed. Not charged.
- `429`: Rate limited, free tries used up, or the uncharged-result limit reached. See Retry-After.

---

[API](https://skmtc.dev/unstuckapi/apis/unstuck-api.md) · [All operations](https://skmtc.dev/unstuckapi/apis/unstuck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unstuckapi/apis/unstuck-api/revisions/ef3ec951224f?raw)