User/Pass Auth
Password Demo Example
API extraction
API Tutorial Demo
Username/Password Extraction
COUNTRY
STATES AND PROVINCES
CITY
SELECT THE TYPE
SUB-ACCOUNT
No verified account yet?Create one.
PROXY ADDRESS
HOST PORT
USERNAME
PASSWORD
Test Command(socks5 Please put it below http:// change socks5://)
BATCH GENERATION
Copy
Generation
Any questions? Please check the usage tutorial
Error code
Code
DESCRIPTION
400
The format of the account and password is incorrect.
401
There is insufficient traffic balance.
402
Insufficient traffic balance
403
Insufficient sub account traffic restrictions
405
Unable to find exit node
406
Unable to find exit node
407
Authentication failed
408
IP not added to whitelist
409
Request for region not set
410
Unable to find exit node
411
Export configuration error
412
Unable to find exit node
413
Export configuration error
414
Unable to find exit node
415
Unable to find exit node
416,417,418,419
Cannot find sub account
420
The authentication account password is empty
421
The authentication account password is incorrect
423
Use mainland network access
424
Sub user suspended
User Guide
Parameter
DESCRIPTION
REQUIRED
zone
Region, do not fill in default global mixing
Yes
st
State, included in some countries, not filled in default random
No
city
City, default random if not filled in
No
sid
8-bit random pure number
No
time
Duration less than 180 minutes
No
Usage method
Zone - designated area

[account]_custom_zone_BR:[password]

zone_BR

zone_JP

zone_GB

zone_KR

example:

# visit

curl -x us.proxy001.com:7878 -U "[account]_custom_zone_KR:[password]" ipinfo.io

ST - Designated State

[account]_custom_zone_US_st_California:[password]

st_California

st_Florida

st_Oregon

st_NorthCarolina

example:

# visit

curl -x us.proxy001.com:7878 -U "[account]_custom_zone_US_st_California:[password]" ipinfo.io

City - Designated City

[account]_custom_zone_US_st_Mississippi_city_Jackson:[password]

city_Tremont

city_Jackson

example:

# visit

curl -x us.proxy001.com:7878 -U "[account]_custom_zone_US_st_Mississippi_city_Jackson:[password]" ipinfo.io

SID - Randomly assign a fixed exit IP

[account]_custom_zone_global_sid_14675113:[password]

example:

# visit

curl -x us.proxy001.com:7878 -U "[account]_custom_zone_global_sid_14675113:[password]" ipinfo.io

Time - Maximum duration for a fixed exit IP: 180 minutes

Use with SID

[account]_custom_zone_global_sid_14675113_time_20:[password]

time_5

5 minutes

time_10

10 minutes

time_30

30 minutes

example:

# visit

curl -x us.proxy001.com:7878 -U "[account]_custom_zone_global_sid_14675113_time_20:[password]" ipinfo.io

Choose language
C/C++
GO
Node.js
PHP
JAVA
Python
C/C++
#include <iostream>
#include <string>
#include <curl/curl.h>

// Callback function, used to process HTTP response data
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* s) {
    size_t newLength = size * nmemb;
    s->append((char*)contents, newLength);
    return newLength;
}

int main() {
    CURL* curl;
    CURLcode res;
    std::string readBuffer;

    // Initialize libcurl
    curl_global_init(CURL_GLOBAL_ALL);

    // Get a CURL handle
    curl = curl_easy_init();
    if(curl) {
        // Set proxy URL and port、username and password
        const char* proxyUrl = "http://Proxy URL:port";
        const char* proxyUserpwd = "username:password";
        curl_easy_setopt(curl, CURLOPT_PROXY, proxyUrl);
        curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, proxyUserpwd);

        // Set target URL
        curl_easy_setopt(curl, CURLOPT_URL, "http://ipinfo.io");

        // Set callback function to handle HTTP response data
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);

        // Execute HTTP requests
        res = curl_easy_perform(curl);

        // Check if the request was successful
        if(res != CURLE_OK) {
            std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
        } else {
            // Print the return result
            std::cout << "Response:\n" << readBuffer << std::endl;
        }

        // clean
        curl_easy_cleanup(curl);
    }

    // clean
    curl_global_cleanup();

    return 0;
}
          
GO
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

var proxy_server = "http://Proxy URL:port"
var username = "username"
var password = "password"

func main() {
	// Set proxy URL
	proxyURL, err := url.Parse(proxy_server)
	if err != nil {
		fmt.Printf("Failed to parse proxy URL: %v\n", err)
		return
	}

	//
	proxyURL.User = url.UserPassword(username, password)

	// Create Transport
	transport := &http.Transport{
		Proxy: http.ProxyURL(proxyURL),
	}

	// Create client
	client := &http.Client{
		Transport: transport,
	}

	// Send request
	resp, err := client.Get("http://ipinfo.io")
	if err != nil {
		fmt.Printf("request failure: %v\n", err)
		return
	}
	defer resp.Body.Close()

	// Read response
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Printf("Read response fail: %v\n", err)
		return
	}

	// Output result
	fmt.Printf("status: %d\n", resp.StatusCode)
	fmt.Printf("Response content:\n%s\n", string(body))
}
          
Node.js
#!/usr/bin/env node
require('request-promise')({
    url: 'https://ipinfo.io',
    proxy: 'http://???-zone-custom:????@us.proxy001.com:7878',
    })
.then(function(data){ console.log(data); },
    function(err){ console.error(err); });		       
PHP
// Target URL
$url = "http://ipinfo.io";

// Proxy server information
$proxy = "us.proxy001.com:7878"; // Replace with your proxy address and port
$proxyAuth = "username:password"; //  Replace with agent username and password

// Initialize cURL
$ch = curl_init();
curl_setopt($ch, CURLOPT_PROXY, $proxy );
curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyAuth);
curl_setopt($ch, CURLOPT_PROXYTYPE,CURLPROXY_HTTP);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
$result = curl_exec($ch);
curl_close($ch);
echo $result;
          
JAVA
import org.apache.http.HttpHost;
import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class auth_demo {
    public static void main(String[] args) {
        String proxyHost = "Proxy ip";
        int proxyPort = 7878;
        String proxyUsername = "username";
        String proxyPassword = "password";
        String targetUrl = "http://ipinfo.io";

        //
        CredentialsProvider credsProvider = new BasicCredentialsProvider();
        credsProvider.setCredentials(
                new AuthScope(proxyHost, proxyPort),
                new UsernamePasswordCredentials(proxyUsername, proxyPassword));

        //
        try (CloseableHttpClient httpClient = HttpClients.custom()
                .setDefaultCredentialsProvider(credsProvider)
                .setProxy(new HttpHost(proxyHost, proxyPort))
                .build()) {

            //
            HttpGet httpGet = new HttpGet(targetUrl);

            //
            HttpResponse response = httpClient.execute(httpGet);

            //
            int statusCode = response.getStatusLine().getStatusCode();
            if (statusCode == 200) {
                //
                String responseBody = EntityUtils.toString(response.getEntity());
                System.out.println("response:\n" + responseBody);
            } else {
                System.out.println("request failed, status code: " + statusCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}
          
Python
import requests

        # Target URL
        url = "http://ipinfo.io"

        proxyserver = "http://Proxy ip:port"#如us.proxy001.com:7878
        username = "username"
        password = "password"

        # Proxy settings
        proxies = {
        }

        try:
            # Send GET request
            response = requests.get(url, proxies=proxies)

            # Check the response status
            response.raise_for_status()

            # Print the return result
            print(response.text)
        except requests.exceptions.RequestException as e:
            # Handling request exceptions
            print(f"request failure: {e}")
          
API extraction
COUNTRY*
QUANTITY EXTRACTED
PROTOCOL
DATA FORMAT
SEPARATOR
Generation
Open >
Whitelist API
Parameter
DESCRIPTION
https://proxy001.com/api/user/white_ip_list?api_key=xxx
Whitelist Query API
https://proxy001.com/api/user/add_white_ip?api_key=xxx&ips=xxx
Whitelist Add Interface (IPS separated by commas in English)
https://proxy001.com/api/user/del_white_ip?api_key=xxx&ips=xxx
Whitelist deletion interface (IPS separated by commas in English)
Instructions
Parameter
DESCRIPTION
TYPE
REQUIRED
num
Number of IP
int
Yes
regions
country
string
Yes
protocol
(http:HTTP/HTTPS socks5:SOCKS5)
string
No
return_type
txt json
string
No
lb
Separator(1:\r\n 2:/br 3: \r 4:\n 5:\t 6 :customize)
int
Yes
sb
custom delimiter
string
No
Result annotation
Parameter
TYPE
DESCRIPTION
IP
int
IP address
PORT
string
Proxy Port
Return result example
{"code": 0, "success": true, "msg": "success", "request_ip": "127.0.0.1", "data": [ {"ip" :"1.1.2.2","port" :14566}, {"ip" :"1.1.2.2","port" :14577}, ] }
Choose language
C/C++
Go
Node.js
PHP
JAVA
Python
C/C++
#include <iostream>
#include <string>
#include <curl/curl.h>

// Callback function, used to process HTTP response data
size_t WriteCallback(void* contents, size_t size, size_t nmemb, std::string* s) {
    size_t newLength = size * nmemb;
    s->append((char*)contents, newLength);
    return newLength;
}

int main() {
    CURL* curl;
    CURLcode res;
    std::string readBuffer;

    // Initialize libcurl
    curl_global_init(CURL_GLOBAL_ALL);

    // Get a CURL handle
    curl = curl_easy_init();
    if(curl) {
        // Set proxy URL and port
        const char* proxyUrl = "http://Proxy URL:port";
        curl_easy_setopt(curl, CURLOPT_PROXY, proxyUrl);

        // Set target URL
        curl_easy_setopt(curl, CURLOPT_URL, "http://ipinfo.io");

        // Set callback function to handle HTTP response data
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);

        // Execute HTTP requests
        res = curl_easy_perform(curl);

        // Check if the request was successful
        if(res != CURLE_OK) {
            std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
        } else {
            // Print the return result
            std::cout << "Response:\n" << readBuffer << std::endl;
        }

        // clean
        curl_easy_cleanup(curl);
    }

    // clean
    curl_global_cleanup();

    return 0;
}
          
GO
package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

var proxy_server = "http://Proxy ip:port"

func main() {
	// Set proxy URL
	proxyURL, err := url.Parse(proxy_server)
	if err != nil {
		fmt.Printf("Failed to parse proxy URL: %v\n", err)
		return
	}

	// Create Transport
	transport := &http.Transport{
		Proxy: http.ProxyURL(proxyURL),
	}

	// Create client
	client := &http.Client{
		Transport: transport,
	}

	// Send request
	resp, err := client.Get("http://ipinfo.io")
	if err != nil {
		fmt.Printf("request failure: %v\n", err)
		return
	}
	defer resp.Body.Close()

	// Read response
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		fmt.Printf("Read response fail: %v\n", err)
		return
	}

	// Output result
	fmt.Printf("status: %d\n", resp.StatusCode)
	fmt.Printf("Response content:\n%s\n", string(body))
}

          
Node.js
#!/usr/bin/env node
require('request-promise')({
    url: 'https://ipinfo.io',
    proxy: 'http://ip:port',
    })
.then(function(data){ console.log(data); },
    function(err){ console.error(err); }); 
PHP

// Target URL
$url = "http://ipinfo.io";

// Proxy server information
$proxy = "198.19.11.12:123"; // Proxy address and port

// Initialize cURL
$ch = curl_init();

// Set cURL options
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_PROXY, $proxy); // proxies
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // Return the result instead of directly outputting it

// Execute request and obtain response
$response = curl_exec($ch);

// Check for errors
if (curl_errno($ch)) {
    echo "cURL error:" . curl_error($ch);
} else {
    echo $response;
}

// close cURL
curl_close($ch);


          
JAVA
import org.apache.http.HttpHost;
import org.apache.http.HttpResponse;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class api_demo {
    public static void main(String[] args) {
        String proxyHost = "Proxy ip";
        int proxyPort = 7878;
        String targetUrl = "http://ipinfo.io";

        //
        CredentialsProvider credsProvider = new BasicCredentialsProvider();
        credsProvider.setCredentials(
                new AuthScope(proxyHost, proxyPort));

        //
        try (CloseableHttpClient httpClient = HttpClients.custom()
                .setDefaultCredentialsProvider(credsProvider)
                .setProxy(new HttpHost(proxyHost, proxyPort))
                .build()) {

            //
            HttpGet httpGet = new HttpGet(targetUrl);

            //
            HttpResponse response = httpClient.execute(httpGet);

            //
            int statusCode = response.getStatusLine().getStatusCode();
            if (statusCode == 200) {
                //
                String responseBody = EntityUtils.toString(response.getEntity());
                System.out.println("response:\n" + responseBody);
            } else {
                System.out.println("request failed, status code: " + statusCode);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

          
Python
import requests

# Target URL
url = "http://ipinfo.io"

# Proxy settings
proxies = {
    'http': 'http://Proxy ip:port',
    'https': 'http://Proxy ip:port'  # Even if HTTPS is not used, it is recommended to set up an HTTPS proxy at the same time
}

try:
    # Send GET request
    response = requests.get(url, proxies=proxies)

    # Check the response status
    response.raise_for_status()

    # Print the return result
    print(response.text)
except requests.exceptions.RequestException as e:
    # Handling request exceptions
    print(f"request failure: {e}")
          
Start Your Secure and Stable
Global Proxy Service
Get started within just a few minutes and fully unleash the potential of proxies.
Start free trial