Making Requests

Basic query

Basic query only requires passing username and password. No other parameters are needed. Such a query will result in the request being made from a random IP address (proxy). Every new request will use a different proxy.

Code examples

In this example, a query to ip.oxylabs.io/location is performed from a random IP:

curl -x pr.oxylabs.io:7777 -U "customer-USERNAME:PASSWORD" https://ip.oxylabs.io/location

A single backconnect proxy (pr.oxylabs.io:7777)enables you to choose a specific country or city proxy via additional parameters in the username. This approach also supports session control. Here is a sample of credentials:

customer-USERNAME-cc-US-city-CITY-sessid-abcde12345:PASSWORD

customer-USERNAME-cc-US-city-CITY-sessid-abcde12345-sesstime-5:PASSWORD

Below is a breakdown of the structure:

Query parameters

Parameter
Description

customer

Username

cc

Case insensitive country code in 2-letter 3166-1 alpha-2 format. For example, DE for Germany, GB for the United Kingdom, TH for Thailand. You can find more details on how to use country-specific proxies here.

city

Case insensitive city name in English. This parameter must be accompanied by cc for better accuracy, for example, cc-GB-city-london for London, United Kingdom; cc-DE-city-berlin for Berlin, Germany. For a city with more than two words, replace space with _, for example, city-st_petersburg or city-rio_de_janeiro. Click here for more information on city-level targeting.

st

Case insensitive US state name with us_ in the beginning, for example, us_california, us_illinois. Click here for more information on state-level targeting.

sessid

Session ID to keep the same IP with upcoming queries. The session expires in 10 minutes. After that, a new IP address is assigned to that session ID. Random string, 0-9, and A-Z characters are supported.

sesstime

The session time parameter keeps the same IP for a certain period. The maximum session time is 30 minutes.

password

Password

- required parameter

Last updated