Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.decodo.com/llms.txt

Use this file to discover all available pages before exploring further.

You may specify your geolocation when making request to a particular website. The accepted geolocation values can be country, state, city or coordinates, and radius, but vary depending on your target URL.

​
Google

​
Country

Pass the full country name just like with the Web Scraping API Geo Parameter Locations. 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
     -H "X-SU-Geo: Germany"

​
City

Pass City, State, Country or State, Country format (depending on the location) to the “X-SU-Geo” header, for example: "X-SU-Geo: New York,New York,United States"or "X-SU-Geo: Berlin, Germany" 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
     -H "X-SU-Geo: Berlin, Germany"

​
State

Pass State, Country format to the "X-SU-Geo" header, for example: "X-SU-Geo: Arizona, United States" 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
     -H "X-SU-Geo: Arizona, United States"

​
Coordinates & Radius

Pass latitude, longitude, and radius to the "X-SU-Geo" header, for example: "X-SU-Geo: lat: 40.8448, lng: -73.8654, rad: 20000". The following example uses coordinates for The Bronx, New York City, USA 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
     -H "X-SU-Geo: lat: 40.8448, lng: -73.8654, rad: 20000"

​
Amazon

For most Amazon URLs, you can either send a zip/postcode or ISO-2 country code. The same rules and exceptions apply as with WEB Scraping API Amazon Geo Parameter.

​
Zip/postcode

Localize results within the native country of the target marketplace, for example, when targeting amazon.com marketplace, you can pass a zipcode to the "X-SU-Geo" header, for example: "X-SU-Geo: 10001" header will have geolocation in New York 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://www.amazon.com/s?k=pikachu" \
     -H "X-SU-Geo: 10001"

​
ISO-2 country code

To localize results to a place outside the native country of the target marketplace, you can use the ISO-2 country code, for example, to get geolocation - France, you could pass this value to the header: "X-SU-Geo: FR". The same exceptions apply as with WEB Scraping API Amazon Geo Parameter.
When scraping Amazon targets from the .com domain, the success rate may be low when using a geolocation that’s identical to the one associated with the domain. For instance, when targeting amazon.com and using X-SU-Geo: US, you will likely get errors.In order to work around this, use localized ZIP codes that are used within the target country, eg.: X-SU-Geo: 10001, which would target New York, US.The same suggestion applies for the following domains: .ca, .co.uk, .com.mx, .de, .fr, .it, .es, .com.br, .in, .co.jp, .nl, .com.au.
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://www.amazon.com/s?k=pikachu" \
     -H "X-SU-Geo: FR"

​
All Other URLs

​
Country

Pass the full country name just like with the Web Scraping API Geo Parameter Locations. 
curl -k -v -x unblock.decodo.com:60000 \
     -U "USERNAME:PASSWORD" "https://ip.decodo.com/" \
     -H "X-SU-Geo: Germany"

​
Header Parameter

Geolocations can also be set through the authentication username. The following example sets a geolocation of Germany: 
curl -k -v -x unblock.decodo.com:60000 \
     -U "username-geo-Germany:password" "https://ip.decodo.com/"

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.