Oxylabs Documentation
English
Search
K

Amazon

There are various page types we can scrape and parse on Amazon. You can either provide us with a full URL or a few input parameters via specifically built data sources (Search, Product, Pricing, Reviews, Questions & Answers, Best Sellers, or Sellers) so we can form the URL on our end.
IMPORTANT: On most page types, Amazon tailors the returned result, based the delivery location of their customers. Therefore, we advise that you use the geo_location parameter to set your preferred delivery location. You can read more about using geo_location with Amazon here.

Overview

Below is a quick overview of all the available data source values we support with Amazon.
Source
Description
Structured data
amazon
Submit any Amazon URL you like.
Depends on the URL.
amazon_bestsellers
List of best seller items in a taxonomy node of your choice.
Yes
amazon_pricing
List of offers available for an ASIN of your choice.
Yes.
amazon_product
Product page of an ASIN of your choice.
Yes.
amazon_questions
Q&A page of an ASIN of your choice.
Yes.
amazon_reviews
Reviews page of an ASIN of your choice.
Yes.
amazon_search
Search results for a search term of your choice.
Yes.
amazon_sellers
Seller information of a seller of your choice.
Yes.
You can always write your own parsing instructions with Custom Parser feature and get structured data.
You can jump to your preferred Amazon page type by selecting the page link below. Each page contains the parameter table as well as code examples to help you get started with your query.

Parameter values

Geo_location

The geo_location parameter value you pass to us will yield a result with a corresponding delivery preference setting, as seen in the screenshots below:
There are a few ways you can use the geo_location parameter to get correctly-localized Amazon results.
For most Amazon domains, you can either send a zip/postcode, or a 2-letter ISO 3166-1 alpha-2 country code. Apart from a few exceptions, it sums up to two cases:
  • To localize the result to a place within the native country of the target marketplace, please use a zip/post code as geo_location parameter value. Examples of accepted domain & geo_location value pairs: {"domain": "com", "geo_location": "90210"}, {"domain": "co.uk", "geo_location": "W105LT"};
  • To localize the result to a place outside the native country of the target marketplace, please use a 2-letter country code. Examples of accepted domain & geo_location value pairs: {"domain":"com", "geo_location": "LT"}, {"domain":"de", "geo_location": "US"}.

Exceptions

Not all Amazon marketplaces are created equal - there are a couple of exceptions to the rules mentioned above:
  • cn and com.tr domains don't support setting a custom delivery location - please don't send the geo_location parameter with requests to these domains;
  • com.au domain doesn't support setting a delivery location outside Australia - please send an Australian postcode with requests to this domain;
  • Instead of postcodes, .ae domain supports UAE city names as geo_location parameter values, e.g. "geo_location":"Abu Dhabi". Of course, you can use 2-letter country codes with this domain, too.

Domain

Use the domain parameter to specify which Amazon marketplace you would like to scrape.
Domain
Marketplace
ae
United Arab Emirates
ca
Canada
cn
China
co.jp
Japan
co.uk
United Kingdom
com
United States
com.au
Australia
com.be
Belgium
com.br
Brazil
com.mx
Mexico
com.tr
Turkey
de
Germany
es
Spain
fr
France
in
India
it
Italy
nl
Netherlands
pl
Poland
se
Sweden

Locale

Use the locale parameter to set the interface language.
Not all Amazon marketplaces allow setting the interface language, and supported languages differ on each marketplace. The table below lists the supported domain and locale value combinations. Some of the languages are marked as default. If you would like to get the default interface language, you don't have to send the locale parameter.
Domain
Locale
Interface language
ae
en_AE
English (default)
ae
ar_AE
Arabic
ca
fr_CA
French
ca
en_CA
English (default)
co.jp
ja_JP
Japanese (default)
co.jp
en_US
English
co.jp
zh_CN
Chinese
co.uk
en_GB
English
com
en_US
English (default)
com
es_US
Spanish
com
ar_AE
Arabic
com
de_US
German
com
he_IL
Hebrew
com
ko_KR
Korean
com
pt_BR
Portuguese
com
zh_CN
Chinese
com
zh_TW
Taiwanese
com.be
fr_BE
French
com.be
nl_BE
Dutch
com.be
en_GB
English
de
de_DE
German (default)
de
en_GB
English
de
cs_CZ
Czech
de
nl_NL
Dutch
de
pl_PL
Portuguese
de
tr_TR
Turkish
eg
ar_AE
Arabic (default)
eg
en_AE
English
es
es_ES
Spanish (default)
es
pt_PT
Portuguese
in
en_IN
English (default)
in
hi_IN
Hindi
in
ta_IN
Tamil
in
te_IN
Telugu
in
kn_IN
Kannada
in
ml_IN
Malayalam
in
bn_IN
Bengali
in
mr_IN
Marathi
nl
nl_NL
Dutch (default)
nl
en_GB
English
sa
ar_AE
Arabic (default)
sa
en_AE
English
se
sv_SE
Swedish (default)
se
en_GB
English