# Zinc Product Search API

> Zinc Product Search API is a paid API for AI agents from api.zinc.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Search for products by keyword on Amazon or Walmart and return listings with price, availability, ratings, and shipping details

## Facts

- Endpoint: POST https://api.zinc.com/agent/products/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zinc-product-search-api-e8575f93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O6kLr4EYI31bIqXm3fERr

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 zinc-product-search-api-e8575f93 -d '<json body>'
```

Example prompt: Search Amazon for 'wireless noise-cancelling headphones' and show me the top results with prices, star ratings, and whether they have Prime shipping.

## When to prefer this

Choose this endpoint when you need to programmatically search Amazon or Walmart product catalogs to retrieve structured product data (IDs, prices, ratings, availability) as part of an automated buying or price-monitoring workflow. It is particularly useful as the discovery step before placing automated orders via the Zinc ordering API. Prefer it over scraping or retail APIs when you need a unified interface for both Amazon and Walmart with downstream purchasing capability.

## Known failure modes

- Invalid retailer value (only 'amazon' or 'walmart' accepted) returns an error status
- Empty query string may return no results or an error
- Pagination with an invalid page token may return empty results
- Free shipping filter is a no-op on Amazon — Amazon results are always returned unfiltered
- An empty page with a non-null next_page does not indicate end of results — agent must continue paginating
- Rate limiting or API key errors if payment/auth is not properly configured

## How this service works

Zinc is infrastructure for developers to search products, place orders, and track shipments through one API. Automate your buying process. Start building now!

## Output

Returns a status field and an array of product results, each containing product_id, title, price (in cents), star rating, number of reviews, availability flags (available, available_online, available_instore), shipping price, Prime eligibility, brand, image URL, UPC, MPN, first-party seller flag, and pagination info (next_page) for fetching additional result pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "query",
  "retailer"
 ],
 "properties": {
  "page": {
   "type": "string",
   "description": "Page number for pagination"
  },
  "query": {
   "type": "string",
   "description": "Search term"
  },
  "retailer": {
   "enum": [
    "amazon",
    "walmart"
   ],
   "type": "string",
   "description": "Retailer: amazon or walmart"
  },
  "free_shipping": {
   "type": "boolean",
   "description": "Only return items that ship for free (Walmart: ship price of 0). Currently a no-op for Amazon: the upstream search data under-reports Prime, so Amazon results are returned unfiltered. Applied per-page after pagination; use `next_page` in the response to keep paging — an empty page with a non-null `next_page` is not the end of results."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "title": "ProductSearchResponse",
 "required": [
  "status"
 ],
 "properties": {
  "status": {
   "type": "string",
   "title": "Status"
  },
  "results": {
   "type": "array",
   "items": {
    "type": "object",
    "title": "ProductSearchResult",
    "required": [
     "product_id",
     "title"
    ],
    "properties": {
     "mpn": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Mpn"
     },
     "upc": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Upc"
     },
     "addon": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Addon"
     },
     "brand": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Brand"
     },
     "fresh": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Fresh"
     },
     "image": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ],
      "title": "Image"
     },
     "price": {
      "anyOf": [
       {
        "type": "integer"
       },
       {
        "type": "null"
       }
      ],
      "title": "Price"
     },
     "prime": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Prime"
     },
     "stars": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ],
      "title": "Stars"
     },
     "title": {
      "type": "string",
      "title": "Title"
     },
     "pantry": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Pantry"
     },
     "preorder": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Preorder"
     },
     "available": {
      "anyOf": [
       {
        "type": "boolean"
       },
       {
        "type": "null"
       }
      ],
      "title": "Available"
     },
     "num_sales": {
      "anyOf": [
       {
        "type": "integer"
       },
       {
        "type": "null"
       }
      ],
      "title": "Num Sales"
     },
   
… (truncated)
```

## More

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