Skip to main content
Core and Advanced plans are no longer available for purchase. Please consider migrating to the all-in-one Web Scraper API; check out the guide here.
The Amazon specific geo parameter should be used with Advanced plans.
For Amazon, you can choose from these geo parameter values:
  • Using a zip code, for example: 99950
# update 'TOKEN VALUE' with your authorization token
curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic TOKEN VALUE' \
     --header 'content-type: application/json' \
     --data '
{
  "target": "amazon",
  "url": "https://www.amazon.com/dp/B09H74FXNW",
  "geo": "99950" 
}
,
  • Using an ISO-2 country code, for example: IT
# update 'TOKEN VALUE' with your authorization token
curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic TOKEN VALUE' \
     --header 'content-type: application/json' \
     --data '
{
  "target": "amazon",
  "url": "https://www.amazon.com/dp/B09H74FXNW",
  "geo": "IT" 
}
,

​
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 country’s ISO code.

​
Example of a correct request

# update 'TOKEN VALUE' with your authorization token
curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic TOKEN VALUE' \
     --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

# update 'TOKEN VALUE' with your authorization token
curl --request POST \
     --url 'https://scraper-api.decodo.com/v2/scrape?amazon_search=' \
     --header 'accept: application/json' \
     --header 'authorization: Basic TOKEN VALUE' \
     --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

Need help or just want to say hello? Our support is available 24/7.
You can also reach us anytime via email at support@decodo.com.

Feedback

Can’t find what you’re looking for? Request an article!
Have feedback? Share your thoughts on how we can improve.