# BaseZOS Amazon Product Search

> BaseZOS Amazon Product Search is a paid API for AI agents from basezos.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Search Amazon product listings and return product details including name, price, image, ratings, and Prime status

## Facts

- Endpoint: POST https://basezos.vercel.app/api/search/amazon-products
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basezos-amazon-product-search-a612bb7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4J2sr0IepWCcp9l9zuH5f

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 basezos-amazon-product-search-a612bb7a -d '<json body>'
```

Example prompt: Search Amazon for 'wireless noise-cancelling headphones' across 2 pages and show me the results with prices, star ratings, and whether they're Prime-eligible.

## When to prefer this

Use this endpoint when you need to programmatically search Amazon product listings by keyword and retrieve structured product data (price, ratings, Prime status) without building your own scraper. Prefer this over generic web search when you specifically need Amazon marketplace results with structured e-commerce fields.

## Known failure modes

- No results returned if search query matches no Amazon listings
- Amazon anti-scraping measures may cause partial or empty results
- Invalid or missing required fields (searchQuery, pages) return a 400-level error
- Rate limiting or upstream Amazon blocks may cause timeouts
- Prices or availability may be stale if cached results are returned

## How this service works

Search Amazon products via API

## Output

An array of Amazon product objects, each containing a product ID, name, URL, price string, image URL, star rating, review count, Prime eligibility flag, and a cached indicator.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "pages",
  "searchQuery"
 ],
 "properties": {
  "pages": {
   "type": "integer"
  },
  "searchQuery": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "items"
 ],
 "properties": {
  "items": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "name",
     "url",
     "price",
     "image"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "image": {
      "type": "string"
     },
     "price": {
      "type": "string"
     },
     "stars": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "string"
       }
      ]
     },
     "cached": {
      "type": "boolean"
     },
     "isPrime": {
      "type": "boolean"
     },
     "reviewsCount": {
      "type": "number"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basezos-amazon-product-search-a612bb7a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from basezos.vercel.app](https://www.zero.xyz/host/basezos.vercel.app/llms.txt)
