Skip to content

Amazon Product Search API

A GET request to our endpoint /api/getter/?platform="amazon_search" will allow you to scrape search results from Amazon's search engine in real-time.

Example

To scrape Amazon's search results for the keyword "pillow", you can use the following command:

1
curl -v -L 'https://data.unwrangle.com/api/getter/?platform=amazon_search&search=toothpaste&country_code=us&api_key=API_KEY'

Note

When using curl, it is necessary to add the option -L to get the data back. This is because in some cases our server responds with a 301 and curl does not follow the redirect by default.

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Search Query

search

Required

Parameter defines the search query you want to search. You can use anything a user may use in a regular Amazon search.

page

Optional

The page number for which you want the results. Default value is 1.

Advanced Amazon Parameters

country_code

Optional

Specifies the country you wish to search Amazon in. Default value is us. Here is a list of supported countries.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be amazon_search.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

Be sure to replace any whitespace in the search keywords with a plus + sign. So, if you're looking to scrape search results for the keyword "ssd 1tb", please set the value of the query parameter search to "ssd+1tb".

Results

Each request returns up to 60 results. The response will include the following attirbutes for each product in the search results:

Attributes Returned Data Type Information Represented
name string Name of product lisitng
URL string URL of product listing
thumbnail string URL of product's thumbnail
rating float Average rating of product
total_ratings int No. of ratings received
price string Price of product
is_sponsored boolean Whether product is ad or not
past_month_bought str Estimated sales in the past month as declared by Amazon

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "category_url": "https://www.amazon.com/s?k=toothpaste",
    "page": 1,
    "total_results": 4000,
    "no_of_pages": 7,
    "result_count": 48,
    "results": [
        {
            "name": "Crest + Scope Complete Whitening Toothpaste, Minty Fresh, 5.4 Oz (Pack of 3) ",
            "url": "https://www.amazon.com/Crest-Complete-Whitening-Toothpaste-Triple/dp/B005PLQIQ4",
            "thumbnail": "https://m.media-amazon.com/images/I/71Md-W5PL9L._AC_UL320_.jpg",
            "rating": 4.8,
            "total_ratings": 41384,
            "price": "$9.00",
            "is_sponsored": false,
            "past_month_bought": "50K+"
        },
        {
            "name": "Colgate Baking Soda & Peroxide Toothpaste - Whitens Teeth, Fights Cavities & Removes Stains, Brisk Mint, 6 Oz, 2 Pack ",
            "url": "https://www.amazon.com/Colgate-Baking-Peroxide-Whitening-Toothpaste/dp/B01BNHREXE",
            "thumbnail": "https://m.media-amazon.com/images/I/71vjF6hh1AL._AC_UL320_.jpg",
            "rating": 4.7,
            "total_ratings": 15308,
            "price": "$3.94",
            "is_sponsored": false,
            "past_month_bought": "40K+"
        },
        ...
        {
            "name": "Crest 3D White Toothpaste, Advanced Luminous Mint, Teeth Whitening Toothpaste, 3.7 Oz (Pack of 4) ",
            "url": "https://www.amazon.com/Crest-White-Luminous-Whitening-Toothpaste/dp/B09F8FZ18G",
            "thumbnail": "https://m.media-amazon.com/images/I/61iPbqQvEHL._AC_UL320_.jpg",
            "rating": 4.8,
            "total_ratings": 88021,
            "price": "$14.99",
            "is_sponsored": false,
            "past_month_bought": "50K+"
        },

Request Cost

Request cost is 1 credit per record returned. Each response typically includes 24 to 48 results.

Supported Countries

The countries we support to scrape Amazon's search results from are listed below:

Country Domain Code
USA Amazon.com us
UK Amazon.co.uk gb
France Amazon.fr fr
Germany Amazon.de de
India Amazon.in in
Australia Amazon.au au
Brazil Amazon.br br
Spain Amazon.es es
Japan Amazon.co.jp jp

Support

If you want to add a parameter to our response, or have any question or feedback, please write to us at support@unwrangle.com