---
title: "Search Amazon product listings"
method: POST
path: "/api/v1/amazon/search"
tags: ["Amazon"]
---

# Search Amazon product listings

`POST /api/v1/amazon/search`

## Request

- Base URL: `https://glim.sh`
- URL: `https://glim.sh/api/v1/amazon/search`
- Auth: one of:
  - none
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in query parameter `apiKey`

Search Amazon by keyword (query) or browse bestsellers by category (category_slug). Regional TLDs: com, co.uk, de, fr, es, it. Returns ranked products with VAT-exclusive net price computed alongside gross.

## Request body

- object
  - `query` string: Free-text keyword query (mutually exclusive with category_slug)
  - `category_slug` string: Amazon bestsellers category slug, e.g. 'electronics' (.com), 'elektronik' (.de), 'electronique' (.fr). Invalid slugs return 'not_found' - retry with a correct slug.
  - `tld` 'com' | 'co.uk' | 'de' | 'fr' | 'es' | 'it': Amazon marketplace: com | co.uk | de | fr | es | it
  - `page` integer: Page number (1-20)
  - `response_format` 'concise' | 'detailed': 'concise' drops images/variants/deep seller metadata; 'detailed' keeps everything
  - `sort_by` 'most_recent' | 'price_low_to_high' | 'price_high_to_low' | 'featured' | 'average_review' | 'bestsellers' | 'most_reviewed': 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.
  - `min_reviews` integer: 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` boolean: Include sponsored ad results (default: dropped)
  - `include_suggested` boolean: Include 'people also searched for' suggestions (default: dropped)
  - `q` string: Alias of 'query'
  - `keyword` string: Alias of 'query'
  - `keywords` string: Alias of 'query'

## Response `200`

Search results

- object

## Other responses

- `400`: Bad Request
- `402`: Payment Required
- `404`: Not Found
- `502`: Upstream Error
- `503`: Temporarily Unavailable

---

[API](https://skmtc.dev/glim/apis/glim-sh.md) · [All operations](https://skmtc.dev/glim/apis/glim-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/glim/apis/glim-sh/revisions/0094e5226d73?raw)