Skip to main content
GET
/
amazon
/
search
Amazon Search
curl --request GET \
  --url https://api.example.com/amazon/search

​
Overview

The /amazon/search endpoint searches Amazon’s product catalog and returns structured product data including pricing, ratings, reviews, and availability. The API handles Amazon’s anti-bot measures and provides clean, parsed data.

​
Parameters

​
Query Parameters

​
q
string
required
The product search query
​
amazonDomain
string
default:"www.amazon.com"
Amazon domain to search. Options include:
  • www.amazon.com (US)
  • www.amazon.co.uk (UK)
  • www.amazon.de (Germany)
  • www.amazon.fr (France)
  • www.amazon.co.jp (Japan)
  • www.amazon.in (India)
​
page
number
default:"1"
Page number for pagination (starts at 1)
​
department
string
Department or category filter (e.g., Electronics, Books, Clothing)
​
sortBy
string
Sort order for results:
  • relevanceblender - Relevance (default)
  • price-asc-rank - Price: Low to High
  • price-desc-rank - Price: High to Low
  • review-rank - Average Customer Review
  • date-desc-rank - Newest Arrivals
​
priceMin
number
Minimum price filter
​
priceMax
number
Maximum price filter
​
prime
boolean
default:"false"
Filter for Prime-eligible products only
​
country
string
default:"us"
Country code for proxy location (e.g., us, uk, de)
​
rawHtml
boolean
default:"false"
Return raw HTML instead of parsed results
​
async
boolean
default:"false"
Async mode - returns job ID immediately for later retrieval

​
Example Requests

curl -X GET "https://api.scrapengine.io/api/v1/amazon/search?q=wireless%20headphones&page=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Filtered Search with Price Range

curl -X GET "https://api.scrapengine.io/api/v1/amazon/search?q=laptop&priceMin=500&priceMax=1500&prime=true&sortBy=review-rank" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Search on Different Amazon Domain

curl -X GET "https://api.scrapengine.io/api/v1/amazon/search?q=headphones&amazonDomain=www.amazon.co.uk&country=uk" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

​
Success Response (200)

Returns parsed product search results: 
{
  "searchInfo": {
    "query": "wireless headphones",
    "totalResults": 10000,
    "page": 1
  },
  "products": [
    {
      "position": 1,
      "asin": "B0BXY4SQ6X",
      "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
      "link": "https://www.amazon.com/dp/B0BXY4SQ6X",
      "image": "https://m.media-amazon.com/images/I/51aXvjzcukL._AC_SL1500_.jpg",
      "price": {
        "current": 328.0,
        "currency": "USD",
        "original": 399.99,
        "discountPercent": 18
      },
      "rating": {
        "value": 4.6,
        "count": 12543
      },
      "isPrime": true,
      "isSponsored": false,
      "badge": "Best Seller"
    },
    {
      "position": 2,
      "asin": "B09XS7JWHH",
      "title": "Apple AirPods Pro (2nd Generation)",
      "link": "https://www.amazon.com/dp/B09XS7JWHH",
      "image": "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg",
      "price": {
        "current": 189.99,
        "currency": "USD"
      },
      "rating": {
        "value": 4.7,
        "count": 89234
      },
      "isPrime": true,
      "isSponsored": false
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 400,
    "nextPage": "https://api.scrapengine.io/api/v1/amazon/search?q=wireless+headphones&page=2"
  }
}

​
Response Headers

HeaderDescription
x-remaining-creditsNumber of API credits remaining
x-trace-idUnique identifier for the request

​
Error Responses

StatusDescription
400Bad Request - Invalid query parameters
401Unauthorized - Invalid or missing API key
429Too Many Requests - Rate limit exceeded
500Internal Server Error

​
Use Cases

  • Price monitoring: Track product prices and discounts over time
  • Competitor analysis: Monitor competitor product listings and pricing
  • Market research: Analyze product trends and bestsellers
  • Inventory tracking: Monitor product availability and stock levels
  • Review analysis: Collect product ratings and review counts
  • Product discovery: Find new products in specific categories