# Google Shopping Search

> Google Shopping Search is a paid API for AI agents from agent-commerce-factory-jm.austriaeast.cloudapp.azure.com, paid per call via x402, $0.0035/call, status unknown (last checked 2026-10-14).

Search Google Shopping across multiple retailers and return normalized product listings with price, seller, rating, and image data.

## Facts

- Endpoint: POST https://agent-commerce-factory-jm.austriaeast.cloudapp.azure.com/v1/google-shopping/search?utm_source=zero.xyz
- Price: $0.0035/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/google-shopping-search-1c3e67d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wVXA6_OeeL2F8fM8wEoch

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability google-shopping-search-1c3e67d5 -d '<json body>'
```

Example prompt: Search Google Shopping for 'Sony WH-1000XM5 headphones' and show me the top 10 results with price, seller, rating, and a link to buy — search in English for the US market.

## When to prefer this

Prefer this endpoint when you need real-time Google Shopping product listings with normalized price, seller, rating, and image data across multiple retailers. It is ideal for shopping agents doing price comparison, retailer discovery, or product research. Choose this over Amazon-specific endpoints when you want broad multi-retailer coverage rather than ASIN-level offer data.

## Known failure modes

- Empty results if query matches no Google Shopping listings
- Query too long (over 700 characters) returns validation error
- Depth out of range (must be 1–40) returns schema validation error
- Invalid or unsupported locationCode may yield empty or irrelevant results
- Payment failure (x402) if USDC balance insufficient
- Timeout or upstream Google Shopping outage returns server error

## How this service works

Search Google Shopping across retailers. Returns normalized product title, price, currency, seller, rating, review count, product URL, image and rank. For shopping agents, retailer discovery and price research.

## Output

Returns a ranked list of product items, each containing: product title, price (numeric), currency code, seller name, star rating, review count, product page URL, image URL, product ID, and rank. Also includes the original query, route/machine metadata, and economics (sell price in USD, upstream cost).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "depth": {
       "type": "integer",
       "default": 40,
       "maximum": 40,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "maxLength": 700,
       "minLength": 1
      },
      "languageCode": {
       "type": "string",
       "default": "en"
      },
      "locationCode": {
       "type": "integer",
       "default": 2840,
       "minimum": 1
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "machine",
      "route",
      "items"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "items": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "url": {
          "type": [
           "string",
           "null"
          ]
         },
         "rank": {
          "type": [
           "integer",
           "null"
          ]
         },
         "price": {
          "type": [
           "number",
           "null"
          ]
         },
         "title": {
          "type": [
           "string",
           "null"
          ]
         },
         "rating": {
          "type": [
           "number",
           "null"
          ]
         },
         "seller": {
          "type": [
           "string",
           "null"
          ]
         },
         "reviews": {
          "type": [
           "integer",
           "null"
          ]
         },
         "currency": {
          "type": [
           "string",
           "null"
          ]
         },
         "imageUrl": {
          "type": [
           "string",
           "null"
          ]
         },
         "productId": {
          "type": [
           "string",
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/google-shopping-search-1c3e67d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-commerce-factory-jm.austriaeast.cloudapp.azure.com](https://www.zero.xyz/host/agent-commerce-factory-jm.austriaeast.cloudapp.azure.com/llms.txt)
