Amazon Geo

Web Scraping API Amazon Geo Parameter

📘

Amazon specific geo parameter should be used with Advanced plans. Core plans do not require specific geo parameter for amazon target, more information here

For Amazon, you can choose from these geo parameter values:

  • Using a zip code, for example: 99950
curl -u username:password -X POST --url https://scraper-api.decodo.com/v2/scrape -H "Content-Type: application/json" -d "{\"target\": \"amazon\", \"url\": \"https://www.amazon.com/dp/B09H74FXNW\", \"geo\": \"99950\", \"parse\": \"true\"}"
  • Using an ISO-2 country code, for example: IT
curl -u username:password -X POST --url https://scraper-api.decodo.com/v2/scrape -H "Content-Type: application/json" -d "{\"target\": \"amazon\", \"url\": \"https://www.amazon.com/dp/B09H74FXNW\", \"geo\": \"IT\", \"parse\": \"true\"}"

🚧

There are some exceptions for Amazon to the above rules:

  • .cn, .com.tr, .com.be and .nl domains will not work properly as geo parameter value due to Amazon configuration.
  • .com.au domain only works for orders to Australia so you will need to use an Australian zip code in the geo parameter.
  • The .ae domain supports UAE city names, instead of postcodes, for example: "geo": "Abu Dhabi".

📘

Note, that if the domain parameter matches the geo, for example - .com with US, .co.jp with JP, you will have to use the zip code instead of the countries ISO code.

Example of a correct request:

curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic ==' \
     --header 'content-type: application/json' \
     --data '
{
  "target": "amazon_search",
  "query": "reverse uno card",
  "domain": "com", # American domain
  "geo": "00000"  # American zip code
}
'

Example of an incorrect request:

curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic ==' \
     --header 'content-type: application/json' \
     --data '
{
  "target": "amazon_search",
  "query": "reverse uno card",
  "domain": "com", # American domain
  "geo": "US" # American ISO code
}
'

📘

For a more general view check the Web Scraping API Localisation article here.


Support

Still can't find an answer? Want to say hi? We take pride in our 24/7 customer support. Alternatively, you can reach us via our support email at [email protected].

Feedback

Something's missing? Request an article!
Got feedback? Let us know how we're doing and what can be improved.


```