Set up your proxy user

Create an account on the Oxylabs dashboard. Your proxy username and password are the credentials to access the service.

Send a cURL request

Once you’ve created a proxy user, you’ll find a cURL example that you can use to receive a random IP:

curl -x dc.oxylabs.io:8000 -U "user-USERNAME:PASSWORD" https://ip.oxylabs.io/location

Replace USERNAME and PASSWORD with your proxy user credentials. Enter this command in your terminal or another setup to make a basic request with the first IP from your proxy list.

IP control

You can also use a specific static port to make requests. You will find port numbers in your proxy list. To do so, you should navigate to My Products -> Datacenter Proxies -> Proxy list.

Here is an example using a port (8001) for a static session:

curl -x dc.oxylabs.io:8001 -U user-USERNAME:PASSWORD https://ip.oxylabs.io/location

Verify IP parameters

Use ip.oxylabs.io/location to check the parameters of your IPs. This endpoint provides information from four geolocation databases: MaxMind, IP2Location, DB-IP, and IPinfo.io. The details include IP address, provider, country, city, ZIP code, ASN, organization name, time zone, and meta information when available.

Location parameters

To determine the location of your IPs, use https://ip.oxylabs.io/location. Accessing an IP with a specific location does not require additional parameters. Simply send a request to the port corresponding to the IP assigned to your desired location.

Select country

For rotating IPs within a specific country, include a country parameter in your user string. For instance, to rotate only within the US proxy pool, use the parameter country-US:

curl -x dc.oxylabs.io:8000 -U "user-USERNAME-country-US:PASSWORD" https://ip.oxylabs.io/location

🙌 Need Assistance? For support, contact us via live chat or email at [email protected].

🎯 Looking for a Custom Solution or Free Trial? Book a call with our sales team. For custom pricing, advice, or a free trial, reach out to us at [email protected].