# glim.sh Amazon Search

> glim.sh Amazon Search is a paid API for AI agents from surf.cascade.fyi, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches Amazon product listings (organic results) across multiple country storefronts by keyword query or bestsellers category, returning titles, ASINs, prices, and currencies.

## Facts

- Endpoint: POST https://surf.cascade.fyi/api/v1/amazon/search
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/glim-sh-amazon-search-b341e1f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9-yqwoONglKII06zPaj3_

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-search-b341e1f5 -d '<json body>'
```

Example prompt: Search Amazon Germany (de) for 'wireless headphones' and give me the first page of results in detailed format — I want titles, ASINs, and prices.

## When to prefer this

Use this endpoint when you need live Amazon product search results — including prices, titles, and ASINs — across multiple country storefronts (US, UK, DE, FR, ES, IT) without managing your own scraping infrastructure or API keys. Ideal for price lookups, product discovery, and bestseller browsing in agent workflows.

## Known failure modes

- Invalid TLD enum value returns validation error
- Providing both query and category_slug simultaneously may cause conflict
- Page number outside 1-20 range may return error or empty results
- Keyword with no results returns empty organic array
- Network or upstream Amazon scraping failure returns 5xx error

## How this service works

One remote endpoint gives your agent live data from Twitter, Reddit, the open web, GitHub and more. No API keys, no scraping stack - just connect the URL and go.

## Output

A JSON object containing the TLD, mode (query or category), page number, and an array of organic product listings 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-search-b341e1f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from surf.cascade.fyi](https://www.zero.xyz/host/surf.cascade.fyi/llms.txt)