Country Targeting
If IPs from a specific country are needed, then modify the endpoint to include thecountry-xx parameter. Use two-letter Alpha-2 codes. There is a full list of them here.
Example of a rotating proxy that returns IPs from the US:
City Targeting
Add acity-xxxx parameter to the endpoint to specify a city within a country.
It’s used in conjunction with the country parameter and is not standalone.
If the city name consists of multiple words, then use underscores.
Example of a rotating proxy that returns IPs from New York City:
State Targeting
Adding thestate-us_xxxxx to your endpoint will allow for state targeting. Only US states are currently supported.
An example of a rotating proxy that returns IPs from the state of New York:
Continent Targeting
Adding thecontinent parameter to your endpoint will allow you to target IPs from a specific continent.
An example of a rotating proxy that returns IPs from Europe:
ASN Targeting
Adding theasn parameter will allow you to target IPs from a specific carrier.
- You must choose between
citytargeting andasntargeting, as they can’t be used simultaneously.- The same logic would apply to the
continent,stateandcountryparameters.
- The same logic would apply to the
- An example of a proxy with the AT&T Mobility LLC
asnnumber with a rotating session:
Carrier Numbers
You can look up carrier numbers by searching online, for example here .ZIP Targeting
Adding thezip parameter will allow you to target IPs within a specific ZIP code area.
- ZIP-level targeting is only possible with the USA country level, and it must be specified in order to use the
zipparameter. - A maximum of 5 symbols is allowed with the
zipparameter. - An example of a rotating proxy with a
zipcode located in New York City:
Geohash Targeting
Adding thegeohash parameter will allow you to target IPs within a specific geographic grid cell by its geohash code.
- Accepts geohash codes of level 1–4 (1 = largest area, up to ~5,000 × 5,000 km; 4 = smallest, down to ~39.1 × 19.5 km).
- An example of a rotating proxy with a
geohashvalue located in New York City:
Geohash converter
You can convert coordinates from a specific area by searching for geohash encoders online, for example, here.Sticky Session
The examples above have been performed using a rotating session, so you’ll get a new IP address with each request. Adding thesession variable to the endpoint will allow the IP address to persist for multiple requests.
An example of a Sticky session that returns IP addresses from the US:
Different session parameter values are used to differentiate between active sessions and behave just like the different sticky proxy ports with our country endpoints.
For example, if you run the command above with the session variable
randomstring123, you will see that the same proxy IP persists even if you adjust other parameters, such as the country, city, etc.
That means if you require changing the location or rotating the proxy IP sooner, the session parameter must be changed as well. Otherwise, the IP address will not rotate.
Maintaining Sessions With Ports
Alternatively, you can use ports instead of thesession parameter. E.g.:country-us-sessionduration-60.gate.decodo.com:10001;country-us-sessionduration-60.gate.decodo.com:10002;country-us-sessionduration-60.gate.decodo.com:10003.
10001-49999.Session Duration
Addingsessionduration-x to the endpoint will allow the session to persist for up to 24 hours.
An example of a sticky IP from Chicago that will persist for up to 90 minutes:
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.
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.
Have feedback? Share your thoughts on how we can improve.