---
title: Search endpoint
description: Run Amazon keyword searches and get ranked product listings with organic/sponsored positions, prices, ratings, and images.
order: 20
---

# `GET /v1/amazon/search`

Returns Amazon search-results listings for a keyword query.

## Request

```http
GET /api/v1/amazon/search?query=wireless+headphones&domain=com&sort_by=best_match
Authorization: Bearer asa_live_YOUR_KEY
```

### Query parameters

| Param | Type | Required | Default | Description |
|---|---|---|---|---|
| `query` | string | ✅ yes |  -  | Search keywords |
| `domain` | enum |  -  | `com` | Amazon marketplace TLD |
| `sort_by` | enum |  -  | `best_match` | `best_match` · `price_asc` · `price_desc` · `avg_customer_review` · `newest` |
| `start_page` | int |  -  | `1` | Page to start from (1-10) |
| `pages` | int |  -  | `1` | Number of consecutive pages to fetch (1-10)  -  each counts as a request |

### Response (200)

```json
{
  "page": 1,
  "products": [
    {
      "asin": "B0BDHWDR12",
      "title": "Sony WH-1000XM5 Wireless Noise-Cancelling Headphones",
      "url": "https://www.amazon.com/dp/B0BDHWDR12",
      "price": 348.00,
      "price_strikethrough": 399.99,
      "currency": "USD",
      "rating": 4.5,
      "reviews_count": 18420,
      "image": "https://m.media-amazon.com/images/I/71…",
      "is_prime": true,
      "is_amazons_choice": false,
      "is_sponsored": false,
      "best_seller": true,
      "organic_position": 1,
      "sponsored_position": null,
      "shipping_information": "FREE delivery",
      "manufacturer": "Sony",
      "is_video": false
    }
  ],
  "html": null
}
```

## Common errors

Same as the product endpoint. `502 target_unreachable` on international marketplaces is more common than on `.com`  -  see our [country routing guide](/docs/guides/country-and-language).

## Related

- [Product endpoint](/docs/endpoints/product)
- [Batch a hundred search queries](/docs/endpoints/batch)