# StableNinja Amazon Product Search

> StableNinja Amazon Product Search is a paid API for AI agents from stableninja.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Search Amazon product listings by keyword with filtering by country, sort order, condition, and page.

## Facts

- Endpoint: GET https://stableninja.dev/api/amazon/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stableninja-amazon-product-search-3618bf39
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_G3Yqv-aM2TqLwjeF__To3

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 stableninja-amazon-product-search-3618bf39
```

Example prompt: Search Amazon US for 'wireless noise-cancelling headphones', sorted by highest rating, only new condition, and show me the first page of results.

## When to prefer this

Use this endpoint when you need to programmatically search Amazon product listings by keyword with flexible filtering by country, sort order (relevance, price, rating, etc.), and product condition. Prefer this over general web search when you specifically want structured Amazon marketplace data rather than generic shopping results.

## Known failure modes

- Missing required 'query' parameter returns validation error
- Invalid country code not in supported enum returns error
- Page number below 1 or non-integer returns validation error
- No results found for obscure keyword returns empty list
- Rate limiting or payment failure returns 402 or related error

## How this service works

Search Amazon products by keyword.

## Output

A list of Amazon product listings matching the keyword query, including product names, prices, ratings, and other listing details, filtered and sorted according to the specified parameters.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "query"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 1
      },
      "query": {
       "type": "string",
       "minLength": 1
      },
      "country": {
       "enum": [
        "US",
        "AU",
        "BR",
        "CA",
        "CN",
        "FR",
        "DE",
        "IN",
        "IT",
        "MX",
        "NL",
        "SG",
        "ES",
        "TR",
        "AE",
        "GB",
        "JP",
        "SA",
        "PL",
        "SE",
        "BE",
        "EG",
        "ZA",
        "IE"
       ],
       "type": "string"
      },
      "sort_by": {
       "enum": [
        "RELEVANCE",
        "LOWEST_PRICE",
        "HIGHEST_PRICE",
        "HIGHEST_RATING",
        "NEWEST_ARRIVALS",
        "BEST_SELLERS",
        "MORE_BUYING_CHOICES"
       ],
       "type": "string"
      },
      "product_condition": {
       "enum": [
        "ALL",
        "NEW",
        "USED",
        "RENEWED",
        "COLLECTIBLE"
       ],
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

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