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.

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

pageURLpageSearchpageProductpagePricingpageReviewspageQuestions & AnswerspageBest SellerspageSellers

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.

DomainMarketplace

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.

DomainLocaleInterface 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

Last updated