Oxylabs Documentation
English
Search
⌃K

Backconnect Entry Node

A single backconnect proxy enables you to choose a specific country or city proxy via additional parameters in the username. This approach also supports session control. Below is a sample of credentials structure:
customer-USERNAME-cc-US-city-CITY-sessid-abcde12345:PASSWORD

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. We support every city in the world, but we do not guarantee we will have proxies there. Most popular cities are well covered and will have many proxies to choose from. For reference, you can download the supported_cities file below this table. 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. Download the full list of supported states below this table.
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.
password
Password
- required parameter
supported_cities.csv
22KB
Text
us_states.txt
673B
Text
We also support targeting by ASN number. It enables you to choose proxies from specific carriers. We enable this feature upon request.
If you add more than one location parameter in the username, the system will ignore all but one. Therefore it is important to understand which parameters get prioritized. The hierarchy is as follows:
  1. 1.
    city
  2. 2.
    state
  3. 3.
    cc
For example, if your query has customer-username-cc-US-city-paris-st-us_california parameters, you will get a proxy from Paris, US.