API Access

Local Proxies User’s Manual

To connect to a proxy please set PROXY in your browser or software to HTTP proxy and set the address to: proxy.localproxies.com, port: 700. The supported authentication method is Basic. If you wish to use SOCKS protocol please set your browser or software to SOCKS proxy and set address to: proxy.localproxies.com, port: 600.
Your basic proxy settings will be emailed to you after your subscription, you can add advanced proxy selection if you need more precise proxy parameters. Your username is where you enter all your individual proxy specifications.

Advanced Proxy Selection (available only in Exclusive service by default, please contact us to enable it for Backconnect and Mailing service)

All proxy specifications are entered for each proxy through username through a flag system. Flags are pre-defined parameters that are available for our customers. Those parameters can be changed and defined as you wish. In the most basic example, the username will be only his email address. By using only this and no other flag, the user will get access to a random proxy that will be changed every 10 minutes. That’s a default pre-defined setting. Advanced flags will offer you more choices.

Advanced flags usage instructions:

Advanced flags need to be entered as username, as standalone flag or combination of flags for more detailed IP address selection.

C – Country – ISO country shortcut or ANY for random country

C and LO, LA flags cannot be used simultaneously. If a country flag is used, then LO and LA flags cannot be used.

CI – City – City to select IP address from – must be URL ENCODED (for example use urlencode function in PHP) – to use this flag C flag must be provided as well.

RG – Region – Specifies a region within a country, must be used with a C flag

SE – service name flag – It’s mandatory and its value is sent to you in subscription e-mail

T – Time – int32 number for a time in minutes or int32 number plus one of 4 letters: s (second), m (minute), h (hour), d (day), w (week), mo (month), y (year).
If you don’t want to change IP periodically please set this flag to 0.

S – Session – random int64 number – adding this flag assigns particular IP to session ID, if this IP becomes unavailable error will be returned. If the client wants to get access to this specific IP in the future and IP is available at the moment he provides this session ID and all other flags are ignored in this case. With this flag, automatic IP change is turned off.

If S flag is set and IP was already assigned to this session number then all other flags are going be ignored. In this case, if IP assigned to this session is not available at the moment error  “SESSION_NOT_AVAILABLE” will be returned.

LO, LA – Longitude, Latitude – GPS coordinates of the desired location – when using this available location closest to the specified coordinates will be assigned – those flags need to be correct GPS coordinates

D – Domain – domain name to check.

Adding this flag means that proxy should have IP address that was not used for a particular domain name.

DT – Time since last domain access – Specifies minimum period of time since a particular IP address was not accessed on a particular domain (set with D parameter).

If D is set but DT is not, a default value of DT is 1m (1 month).

DT values can be: s (second), m (minute), h (hour), d (day), w (week), mo (month), y (year).

If you request a new IP for example by setting new S flag or requesting IP from another country it is possible that there is no IP available at the moment then you are going to get “NO_IP_AVAILABLE” response.

RE – rigorous test that eliminates all non residential IPs – Use “RE-true” in username string to activate this test.

Username flags usage examples:

Flag format that needs to be entered in proxy username filed:
FLAG_NAME-FLAG_VALUE#NEXT_FLAG_NAME-VALUE#youremail@domain.com

There can be more flags added or just email address is enough for basic usage.
Each pair FLAG_NAME-VALUE needs to be separated with a # sign.

Specific examples and explanations:

SE-xxx#youremail@domain.com

Connects to ANY IP for 10 minutes, then assigns a new IP. SE flag is an information about the type of service that you have subscribed, you just need to copy it from your welcome e-mail.

SE-xxx#C-US#T-15#youremail@domain.com

Connects to US IP for 15 minutes, then assigns a new US IP.

SE-xxx#S-56467#C-US#T-10m#youremail@domain.com

Connects to UN IP and assigns IP to a session (56467), flag T is ignored.

SE-xxx#LA-38.779781#LO–102.65625#youremail@domain.com

Connects to IP nearest GPS coordinates provided for 10 minutes, then assigns a new GPS-based IP.

SE-xxx#LA-38.779781#LO–102.65625#D-domain.com#DT-1y#youremail@domain.com

Connects to IP, that was not used to connect with anyone to domain.com in a period of one year, nearest to GPS coordinates provided for 10 minutes, then assigns a new GPS-based IP.
 
 
Sample php code:

function getUrl($url, $port)
{
$ch = curl_init();
curl_setopt ($ch, CURLOPT_CONNECTTIMEOUT, 40);
curl_setopt ($ch, CURLOPT_URL, $url);
curl_setopt ($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_PROXY, "http://proxy.localproxies.com");
curl_setopt($ch, CURLOPT_PROXYPORT, $port);
$file_contents = curl_exec($ch);
curl_close($ch);
return $file_contents;
}