GET /v1/amazon/search

Returns Amazon search-results listings for a keyword query.

Request

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)

{
  "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.

Related

• Product endpoint
• Batch a hundred search queries