Amazon Product Search

Amazon Product Search is used to retrieve Amazon product search results by keyword.

Search Amazon products by keyword
Support region-based results
Support paginated search result retrieval
Return product list data and refinement information

Use XCrawl to Fetch Amazon Product Search Results

Usage

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "amazon_search",
    "keyword": "shoe",
    "location": "US",
    "start_page": 1,
    "pages": 1
  }'

Request parameter notes:

engine must be amazon_search
keyword specifies the search term
location specifies the target region
start_page and pages control the page range to fetch

Response Example

{
  "result": [
    {
      "content": {
        "search_url": "https://www.amazon.com/s?k=shoe",
        "keyword": "shoe",
        "page": 1,
        "pages": 7,
        "products": [
          {
            "asin": "B0XXXXX",
            "title": "Example Product",
            "price": 39.99,
            "currency": "USD",
            "rating": 4.5,
            "reviews": 1200,
            "url": "https://www.amazon.com/..."
          }
        ],
        "refinements": {
          "Brands": [
            {
              "name": "Nike",
              "value": "n:7141123011,p_123:234394"
            }
          ]
        }
      }
    }
  ]
}

Parameters

Required Parameters

Parameter	Type	Description
`location`	`string`	Specifies the target region.
`keyword`	`string`	Specifies the search keyword.
`start_page`	`number`	Specifies the page number to start from.
`pages`	`number`	Specifies how many pages to fetch.

Parameter Notes

location defaults to US
location supports multiple region values such as US, HK, CA, AD, and AE
keyword defaults to an empty string
start_page defaults to 1
pages defaults to 1

Response Fields

Response data is returned under result[].content.

Field	Type	Description
`search_url`	`string`	Search result page URL.
`keyword`	`string`	Current search keyword.
`page`	`number`	Current page number.
`pages`	`number`	Total number of result pages.
`products`	`array`	Product list.
`refinements`	`object`	Search refinement options.

Product Fields

Each item in products[] typically includes:

Field	Type	Description
`asin`	`string`	Amazon ASIN.
`title`	`string`	Product title.
`price`	`number`	Product price.
`currency`	`string`	Price currency.
`rating`	`number`	Product rating.
`reviews`	`number`	Number of reviews.
`url`	`string`	Product detail page URL.

refinements returns filter options that can be used to narrow down the search results, such as brand, department, and seller.

SERP

Engines

Data

APIs