# glim.sh Amazon Product Search

> glim.sh Amazon Product Search is a paid API for AI agents from glim.sh, paid per call via x402, $0.005/call, status healthy (last checked 2026-09-15, last successful call 2026-09-10).

Search Amazon product listings by keyword or bestseller category across multiple international storefronts, returning organic results with ASINs, titles, prices, and currency.

## Facts

- Endpoint: POST https://glim.sh/api/v1/amazon/search
- Price: $0.005/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-15
- Last successful call: 2026-09-10
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 4
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-amazon-product-search-67e755fa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tjQo4e54ec48vHWqA9W5v

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 glim-sh-amazon-product-search-67e755fa -d '<json body>'
```

Example prompt: Search Amazon.de for 'wireless headphones' and show me the first page of results with prices in EUR — use detailed format.

## When to prefer this

Use this endpoint when you need live Amazon product search results across international storefronts without managing your own scraping infrastructure or Amazon API keys. Ideal for price comparison, product discovery, bestseller research, and e-commerce enrichment workflows that need structured ASIN-level data.

## Known failure modes

- Invalid or unsupported TLD returns an error
- Mutually exclusive query and category_slug used together causes a validation error
- Page number outside 1-20 range rejected
- No results found for obscure query returns empty organic array
- Payment failure (402) if USDC balance is insufficient

## How this service works

Search Amazon by keyword or browse bestsellers by category slug

## Output

A JSON object containing the TLD, search mode, page number, and an array of organic product results each with ASIN, title, currency, and gross price.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string",
   "description": "Alias of 'query'"
  },
  "tld": {
   "enum": [
    "com",
    "co.uk",
    "de",
    "fr",
    "es",
    "it"
   ],
   "type": "string",
   "default": "com",
   "description": "Amazon marketplace: com | co.uk | de | fr | es | it"
  },
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 20,
   "minimum": 1,
   "description": "Page number (1-20)"
  },
  "query": {
   "type": "string",
   "description": "Free-text keyword query (mutually exclusive with category_slug)"
  },
  "keyword": {
   "type": "string",
   "description": "Alias of 'query'"
  },
  "sort_by": {
   "enum": [
    "most_recent",
    "price_low_to_high",
    "price_high_to_low",
    "featured",
    "average_review",
    "bestsellers",
    "most_reviewed"
   ],
   "type": "string",
   "description": "Server-side sort, except 'most_reviewed' which re-ranks the current page client-side by review count desc (rating tiebreaker). Pair 'most_reviewed' with min_reviews to skip thinly-reviewed items."
  },
  "keywords": {
   "type": "string",
   "description": "Alias of 'query'"
  },
  "min_reviews": {
   "type": "integer",
   "maximum": 9007199254740991,
   "minimum": 0,
   "description": "Drop hits with fewer than N reviews. Pair with sort_by='most_reviewed' for a trust-weighted result. Applied client-side to organic/paid/suggested."
  },
  "include_paid": {
   "type": "boolean",
   "default": false,
   "description": "Include sponsored ad results (default: dropped)"
  },
  "category_slug": {
   "type": "string",
   "description": "Amazon bestsellers category slug, e.g. 'electronics' (.com), 'elektronik' (.de), 'electronique' (.fr). Invalid slugs return 'not_found' - retry with a correct slug."
  },
  "response_format": {
   "enum": [
    "concise",
    "detailed"
   ],
   "type": "string",
   "default": "concise",
   "description": "'concise' drops images/variants/deep seller metadata; 'detailed' keeps everything"
  },
  "include_suggested": {
   "type": "boolean",
   "default": false,
   "description": "Include 'people also searched for' suggestions (default: dropped)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tld": "de",
  "mode": "query",
  "page": 1,
  "organic": [
   {
    "asin": "B0F59XT8QM",
    "title": "LG Ultragear ...",
    "currency": "EUR",
    "price_gross": 782.04
   }
  ]
 }
}
```

## More

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