# x402serps Shopping Search

> x402serps Shopping Search is a paid API for AI agents from x402serps.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-11).

Returns shopping product results (title, price, store, rating, URL, image) for a single query, up to 20 products

## Facts

- Endpoint: POST https://x402serps.com/api/v1/shopping?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402serps-shopping-search-e18f7f34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OPbrr5-vTX2pVNJdawrAs

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 x402serps-shopping-search-e18f7f34 -d '<json body>'
```

Example prompt: Search for 'wireless noise-cancelling headphones' and give me the top 15 shopping results with prices, store names, ratings, and product images — look in the US market.

## When to prefer this

Use this endpoint when you need structured shopping/product data including prices, store sources, ratings, and product images for a single search query. Prefer it over generic web search when the user specifically wants to find where to buy something, compare prices across retailers, or surface product listings with e-commerce metadata. It is especially useful for price comparison, gift recommendation, or product research workflows.

## Known failure modes

- Invalid or missing query returns an error
- num parameter out of range (must be 1-20) may return an error or be clamped
- Invalid country code (gl) may return no results or default to a fallback country
- Payment failure via x402 protocol results in 402 response with no data
- Query with no shopping results returns an empty results array
- Rate limiting or service unavailability returns a 5xx error

## How this service works

x402serps: Shopping product results (title, price, store, rating, url, image) for one query, up to 20

## Output

A JSON object containing the original query string, provider name, and an array of up to 20 product results each with: position, productId, title, price (string), source (store name), rating (numeric), ratingCount, URL, and imageUrl.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Query (alias: query)"
  },
  "gl": {
   "type": "string",
   "description": "Country code, e.g. us, gb"
  },
  "num": {
   "type": "number",
   "description": "Results 1-20, default 10"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "noise cancelling headphones",
  "results": [
   {
    "url": "https://example.com/p/1",
    "price": "$199.00",
    "title": "Example ANC Headphones",
    "rating": 4.5,
    "source": "Example Store",
    "imageUrl": "https://example.com/p/1.jpg",
    "position": 1
   }
  ],
  "provider": "primary"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402serps-shopping-search-e18f7f34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402serps.com](https://www.zero.xyz/host/x402serps.com/llms.txt)
