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 |
|
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