提出请求

基本查询

要开始使用IPIDEA的动态数据中心，您可以通过代理端点向 https://ipinfo.ipidea.pro 发送请求。只需将 USERNAME和PASSWORD替换为您的 IPIDEA 身份验证凭据。每次查询都会自动轮换您的 IP 地址，为每个请求提供一个新 IP 地址。

验证所分配 IP 的详细信息，如国家、城市、邮政编码、ASN 和时区，可以使用代理服务器查询 ipinfo.ipidea.pro。

IPIDEA的动态数据中心支持多种协议，包括 HTTP、HTTPS 和 SOCKS5。

查询示例：

在本例中，使用随机 IP 向 ipinfo.ipidea.pro 提出请求：

curl -x super.ipidea.pro:7777 -U "USERNAME-zone-static:PASSWORD" ipinfo.ipidea.pro

// demo.cpp : Define the entry point of a console application
        //
        
        #include "stdafx.h"
        #include "curl/curl.h"
        #pragma comment(lib, "libcurl.lib")
        //cURL callback function
        static size_t write_buff_data(char *buffer, size_t size, size_t nitems, void *outstream)
        {
            //Copy the received data to a buffer
            memcpy(outstream, buffer, nitems*size);
            return nitems*size;
        }
        /*
        Use an HTTP proxy
        */
        int GetUrlHTTP(char *url, char *buff)
        {
            CURL *curl;
            CURLcode res;
            curl = curl_easy_init();
            if (curl)
            {
                curl_easy_setopt(curl, CURLOPT_PROXY,"http://proxy server:port");//Set the HTTP proxy address
                curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "USERNAME-zone-static:PASSWORD");//username and password, separated by ":"
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void*)buff);//Set read/write buffers
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_buff_data);//Set callback function
                curl_easy_setopt(curl, CURLOPT_URL, url);//Set URL address
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 10L);//Set a long integer to control the number of seconds to transfer the bytes defined by CURLOPT_LOW_SPEED_LIMIT
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 50L);//Set a long integer to control the number of bytes to transfer
                curl_easy_setopt(curl, CURLOPT_MAX_RECV_SPEED_LARGE, 2000000L);//Maximum download speed
        
                res = curl_easy_perform(curl);
                curl_easy_cleanup(curl);
                if (res == CURLE_OK){
                    return res;
                }else {
                    printf("Error code:%d\n", res);
                    MessageBox(NULL, TEXT("Get IP error"), TEXT("Helper"), MB_ICONINFORMATION | MB_YESNO);
                }
            }
            return res;
        }
        /*
        Use a SOCKS5 proxy
        */
        int GetUrlSocks5(char *url, char *buff)
        {
            CURL *curl;
            CURLcode res;
            curl = curl_easy_init();
            if (curl)
            {
                curl_easy_setopt(curl, CURLOPT_PROXY, "socks5://proxy server:port");//Set the SOCKS5 proxy address
                curl_easy_setopt(curl, CURLOPT_PROXYUSERPWD, "username:password");//username and password, separated by ":"
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void*)buff);//Set read/write buffers
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_buff_data);//Set callback function
                curl_easy_setopt(curl, CURLOPT_URL, url);//Set URL address
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 10L);//Set a long integer to control the number of seconds to transfer the bytes defined by CURLOPT_LOW_SPEED_LIMIT
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 50L);//Set a long integer to control the number of bytes to transfer
                curl_easy_setopt(curl, CURLOPT_MAX_RECV_SPEED_LARGE, 2000000L);/*Maximum download speed*/
                res = curl_easy_perform(curl);
                curl_easy_cleanup(curl);
                if (res == CURLE_OK) {
                    return res;
                }
                else {
                    printf("Error code:%d\n", res);
                    MessageBox(NULL, TEXT("Get IP error"), TEXT("Helper"), MB_ICONINFORMATION | MB_YESNO);
                }
            }
            return res;
        }
        /*
        Don't use a proxy
        */
        int GetUrl(char *url, char *buff)
        {
            CURL *curl;
            CURLcode res;
            //The cURL library used, initialize the cURL library
            curl = curl_easy_init();
            if (curl)
            {
                curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void*)buff);//Set read/write buffers
                curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_buff_data);//Set callback function
                curl_easy_setopt(curl, CURLOPT_URL, url);//Set URL address
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 10L);//Set a long integer to control the number of seconds to transfer the bytes defined by CURLOPT_LOW_SPEED_LIMIT
                curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 50L);//Set a long integer to control the number of bytes to transfer
                curl_easy_setopt(curl, CURLOPT_MAX_RECV_SPEED_LARGE, 2000000L);/*Maximum download speed*/
                res = curl_easy_perform(curl);
                curl_easy_cleanup(curl);
                if (res == CURLE_OK)
                {
                    return res;
                }
                else {
                    printf("Error code:%d\n", res);
                    MessageBox(NULL, TEXT("Get IP error"), TEXT("Helper"), MB_ICONINFORMATION | MB_YESNO);
                }
            }
            return res;
        }
        int main()
        {
            char *buff=(char*)malloc(1024*1024);
            memset(buff, 0, 1024 * 1024);
            //Not use an HTTP proxy
            GetUrl("http://ipinfo.ipidea.pro", buff);
            printf("Not use proxy：%s\n", buff);
            //Use an HTTP proxy
            memset(buff, 0, 1024 * 1024);
            GetUrlHTTP("http://ipinfo.ipidea.pro", buff);
            printf("HTTP result：%s\n", buff);
            //Use a SOCKS5 proxy
            memset(buff, 0,1024 * 1024);
            GetUrlSocks5("http://ipinfo.ipidea.pro", buff);
            printf("SOCKS5 result：%s\n", buff);
        
            free(buff);
            Sleep(10 * 1000);//Wait 10 seconds and exit
                    Wait 10 seconds and exit
            
            return 0;
        }

package main
        
        import (
            "context"
            "fmt"
            "io/ioutil"
            "net"
            "net/http"
            "net/url"
            "strings"
            "time"
        
            "golang.org/x/net/proxy"
        )
        
        // User Pass Auth Setting
        var account = "USERNAME-zone-static"//Proxy_username
        var password = "PASSWORD"//Proxy_password
        
        // Proxy server
        var proxyServer = "HOST:PORT"//Example：xxx.na.ipidea.pro:2336;
        
        // Test URL
        var testApi = "http://ipinfo.ipidea.pro"
        
        func main() {
            go httpProxy(proxyServer, account, password)
            go Socks5Proxy(proxyServer, account, password)
        
            time.Sleep(time.Minute)
        }
        
        // http proxy
        func httpProxy(proxyUrl, user, pass string) {
            defer func() {
                if err := recover(); err != nil {
                    fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), "http", "response:", err)
                }
            }()
            urli := url.URL{}
        
            if !strings.Contains(proxyUrl, "http") {
                proxyUrl = fmt.Sprintf("http://%s", proxyUrl)
            }
        
            urlProxy, _ := urli.Parse(proxyUrl)
            if user != "" && pass != "" {
                urlProxy.User = url.UserPassword(user, pass)
            }
        
            client := &http.Client{
                Transport: &http.Transport{
                    Proxy: http.ProxyURL(urlProxy),
                },
            }
            rqt, err := http.NewRequest("GET", testApi, nil)
            if err != nil {
                panic(err)
                return
            }
            response, err := client.Do(rqt)
            if err != nil {
                panic(err)
                return
            }
        
            defer response.Body.Close()
            body, _ := ioutil.ReadAll(response.Body)
            fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "【http success】", "response:", response.Status, string(body))
        
            return
        }
        
        // socks5 proxy
        func Socks5Proxy(proxyUrl, user, pass string) {
        
            defer func() {
                if err := recover(); err != nil {
                    fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "response:", err)
                }
            }()
        
            var userAuth proxy.Auth
            if user != "" && pass != "" {
                userAuth.User = user
                userAuth.Password = pass
            }
            dialer, err := proxy.SOCKS5("tcp", proxyUrl, &userAuth, proxy.Direct)
            if err != nil {
                panic(err)
            }
            httpClient := &http.Client{
                Transport: &http.Transport{
                    DialContext: func(ctx context.Context, network, addr string) (conn net.Conn, err error) {
                        return dialer.Dial(network, addr)
                    },
                },
                Timeout: time.Second * 10,
            }
        
            if resp, err := httpClient.Get(testApi); err != nil {
                panic(err)
            } else {
                defer resp.Body.Close()
                body, _ := ioutil.ReadAll(resp.Body)
                fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "【socks5 success】", "response:", string(body))
            }
        }

#!/usr/bin/env node
        require('request-promise')({
            url: 'http://ipinfo.ipidea.pro',//Request URL
            proxy: 'http://USERNAME-zone-static:[email protected]:7777',//proxy username-zone-proxy pool:proxy username@proxy server address
            })
        .then(function(data){ console.log(data); },
            function(err){ console.error(err); });

<?php
        //User Pass Auth setting
        $user = "USERNAME-zone-static";//Proxy_username
        $password = "PASSWORD";//Proxy_password
        // Target URL
        $targetUrl = "http://ipinfo.ipidea.pro";
        // Proxy server
        $proxyServer = "proxy address";  //Example：xxx.na.ipidea.pro:2336;
        $proxyUserPwd = "$user:$password";
                                        
        // Tunnel verification
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $targetUrl);
        curl_setopt($ch, CURLOPT_HTTPPROXYTUNNEL, false);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
                                        
        // Set proxy server
        curl_setopt($ch, CURLOPT_PROXYTYPE, 0); //http
        // curl_setopt($ch, CURLOPT_PROXYTYPE, 5); //sock5
        curl_setopt($ch, CURLOPT_PROXY, $proxyServer);
                                        
        // Set tunnel verification information
        curl_setopt($ch, CURLOPT_PROXYAUTH, CURLAUTH_BASIC);
        curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727;)");
        curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
        curl_setopt($ch, CURLOPT_TIMEOUT, 5);
        curl_setopt($ch, CURLOPT_HEADER, true);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_PROXYUSERPWD, $proxyUserPwd);
        $result = curl_exec($ch);
        $err = curl_error($ch);
                                        
        curl_close($ch);
                                        
        var_dump($err);
        var_dump($result);

package demo;
        
        import okhttp3.Credentials;
        import okhttp3.OkHttpClient;
        import okhttp3.Request;
        
        import java.io.IOException;
        import java.net.InetSocketAddress;
        import java.net.PasswordAuthentication;
        import java.net.Proxy;
        
        /**
        * compile 'com.squareup.okhttp3:okhttp:4.9.3'
        */
        class AutProxyJava {
            public static void main(String[] args) throws IOException {
                testWithOkHttp();
        
                testSocks5WithOkHttp();
            }
        
            /**
            * http proxy
            */
            public static void testWithOkHttp() throws IOException {
                String url = "http://ipinfo.ipidea.pro";//Request URL
                //Create a proxy object of type HTTP and specify the host name and port number of the proxy server
                Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("host", "port"));//The "host" and "port" used here should be replaced with the proxy server address and port.
                // Build a custom OkHttpClient instance, set up a proxy server and add a proxy authenticator (proxyAuthenticator)
                OkHttpClient client = new OkHttpClient().newBuilder().proxy(proxy).proxyAuthenticator((route, response) -> {
                    // Generate the credential string for Basic authentication here
                    String credential = Credentials.basic("USERNAME-zone-static", "PASSWORD");//The "USERNAME-zone-static" and "PASSWORD" here should be replaced with proxy username and proxy password.
                    // If proxy server needs authentication, please add authentication information in request head.
                    return response.request().newBuilder()
                            .header("Proxy-Authorization", credential)
                            .build();
                }).build();
        
                //Send GET Request and get response
                Request request = new Request.Builder().url(url).build();
                okhttp3.Response response = client.newCall(request).execute();
                //Get and print response
                String responseString = response.body().string();
                System.out.println(responseString);
            }
        
            /**
            * Socks5 proxy
            */
            public static void testSocks5WithOkHttp() throws IOException {
                //Request URL
                String url = "http://ipinfo.ipidea.pro";
                //Create a SOCKS proxy object and set the actual proxy server host name and port
                Proxy proxy = new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("host", "port"));//The "host" and "port" used here should be replaced with the proxy server address and port.
                //Set the global default authenticator (Authenticator) to handle basic authentication required for all network connections. A username and password are preset here
                java.net.Authenticator.setDefault(new java.net.Authenticator() {
                    private PasswordAuthentication authentication =
                            new PasswordAuthentication("account", "password".toCharArray());//The "account" and "port" here should be replaced with proxy username and proxy password.
        
                    @Override
                    protected PasswordAuthentication getPasswordAuthentication() 
                });
                //Build an OkHttpClient instance and configure the SOCKS proxy
                OkHttpClient client = new OkHttpClient().newBuilder().proxy(proxy).build();
                //Send GET request and get response
                Request request = new Request.Builder().url(url).build();
                okhttp3.Response response = client.newCall(request).execute();
                //Get and print response
                String responseString = response.body().string();
                System.out.println(responseString);
            }
        }

'''
        Import thread, time and request package)
        to realize multiple thread control, waiting and http request)
        '''
        import _thread
        import time
        import requests
        
        # Set request head
        headers = {
            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
            "User-Agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60 MicroMessenger/6.5.19 NetType/4G Language/zh_TW",
        }
        
        # Test URL
        mainUrl = 'http://ipinfo.ipidea.pro'
        
        def testUrl():
            # Set proxy username and password
            proxy = {
                'http': 'http://USERNAME-zone-static:[email protected]:7777',#proxy username:proxy password@proxy server IP:proxy server port
                'https': 'http://USERNAME-zone-static:[email protected]:7777',#proxy username:proxy password@proxy server IP:proxy server port
            }
            try:
                res = requests.get(mainUrl, headers=headers, proxies=proxy, timeout=10)
                print(res.status_code, res.text)
            except Exception as e:
                print("Fail to visit", e)
                pass
        
        # Turn on 10 threads to test
        for i in range(0, 10):
            _thread.start_new_thread(testUrl, ())
            time.sleep(0.1)
        
        time.sleep(10)

针对区域和城市的特定请求

IPIDEA 允许用户通过在用户名中添加参数来指定来自特定国家或城市的代理。此方法还支持会话控制。以下是一些示例凭据：

示例：

要使用来自美国的代理，并对会话或城市级别定位进行额外控制：

USERNAME-zone-static-region-us-city-CITY-session-123keh4ra-sessTime-5:PASSWORD:super.ipidea.pro:7777

参数细分：

让我们分解一下完整的IPIDEA代理用户名的结构：

结构：

USERNAME-zone-static-region-us-city-newyork-session-123keh4ra-sessTime-5:PASSWORD:super.ipidea.pro:7777

USERNAME: 您的IPIDEA帐户用户名，用于身份验证。
zone-static: 表示要使用的住宅代理池。
region-us: 2 个字母的国家代码，用于将代理限制到特定区域，例如美国。.
city-newyork: 以特定城市（在本例中为纽约）为目标的代理。
session-123keh4ra: 确保同一个 IP 在多个请求中保持不变（默认有效期为 5 分钟）。
sessTime-5: 将会话持续时间延长至 5 分钟（可选，最长时间为 120 分钟）。
PASSWORD: 您的 IPIDEA 代理帐户密码。

查询参数

参数

描述

username

代理帐户用户名

zone

IP 池名称

region

国家/地区，随机地区无此参数

您想要指定的状态。

city

您要指定的城市。可以不带“state”参数使用。

session

粘性 IP 和切换 IP 所需。在固定 IP 或切换时查找特定 IP 时使用它。

sessTime

与会话一起使用来设置 IP 持续时间。

password

代理账户密码

需要帮助？

如果您需要进一步说明或位置定位方面的帮助，请随时通过以下方式与我们联系：

电子邮件：[email protected]
在线聊天：在我们的网站上提供24/7实时聊天。

上一页通过白名单进行API提取下一页位置设置

最后更新于18天前

package main import ( "context" "fmt" "io/ioutil" "net" "net/http" "net/url" "strings" "time" "golang.org/x/net/proxy" ) // User Pass Auth Setting var account = "USERNAME-zone-static"//Proxy_username var password = "PASSWORD"//Proxy_password // Proxy server var proxyServer = "HOST:PORT"//Example：xxx.na.ipidea.pro:2336; // Test URL var testApi = "http://ipinfo.ipidea.pro" func main() { go httpProxy(proxyServer, account, password) go Socks5Proxy(proxyServer, account, password) time.Sleep(time.Minute) } // http proxy func httpProxy(proxyUrl, user, pass string) { defer func() { if err := recover(); err != nil { fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), "http", "response:", err) } }() urli := url.URL{} if !strings.Contains(proxyUrl, "http") { proxyUrl = fmt.Sprintf("http://%s", proxyUrl) } urlProxy, _ := urli.Parse(proxyUrl) if user != "" && pass != "" { urlProxy.User = url.UserPassword(user, pass) } client := &http.Client{ Transport: &http.Transport{ Proxy: http.ProxyURL(urlProxy), }, } rqt, err := http.NewRequest("GET", testApi, nil) if err != nil { panic(err) return } response, err := client.Do(rqt) if err != nil { panic(err) return } defer response.Body.Close() body, _ := ioutil.ReadAll(response.Body) fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "【http success】", "response:", response.Status, string(body)) return } // socks5 proxy func Socks5Proxy(proxyUrl, user, pass string) { defer func() { if err := recover(); err != nil { fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "response:", err) } }() var userAuth proxy.Auth if user != "" && pass != "" { userAuth.User = user userAuth.Password = pass } dialer, err := proxy.SOCKS5("tcp", proxyUrl, &userAuth, proxy.Direct) if err != nil { panic(err) } httpClient := &http.Client{ Transport: &http.Transport{ DialContext: func(ctx context.Context, network, addr string) (conn net.Conn, err error) { return dialer.Dial(network, addr) }, }, Timeout: time.Second * 10, } if resp, err := httpClient.Get(testApi); err != nil { panic(err) } else { defer resp.Body.Close() body, _ := ioutil.ReadAll(resp.Body) fmt.Println(time.Now().Format("2006-01-02 15:04:05 07"), proxyUrl, "【socks5 success】", "response:", string(body)) } }

package demo; import okhttp3.Credentials; import okhttp3.OkHttpClient; import okhttp3.Request; import java.io.IOException; import java.net.InetSocketAddress; import java.net.PasswordAuthentication; import java.net.Proxy; /** * compile 'com.squareup.okhttp3:okhttp:4.9.3' */ class AutProxyJava { public static void main(String[] args) throws IOException { testWithOkHttp(); testSocks5WithOkHttp(); } /** * http proxy */ public static void testWithOkHttp() throws IOException { String url = "http://ipinfo.ipidea.pro";//Request URL //Create a proxy object of type HTTP and specify the host name and port number of the proxy server Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress("host", "port"));//The "host" and "port" used here should be replaced with the proxy server address and port. // Build a custom OkHttpClient instance, set up a proxy server and add a proxy authenticator (proxyAuthenticator) OkHttpClient client = new OkHttpClient().newBuilder().proxy(proxy).proxyAuthenticator((route, response) -> { // Generate the credential string for Basic authentication here String credential = Credentials.basic("USERNAME-zone-static", "PASSWORD");//The "USERNAME-zone-static" and "PASSWORD" here should be replaced with proxy username and proxy password. // If proxy server needs authentication, please add authentication information in request head. return response.request().newBuilder() .header("Proxy-Authorization", credential) .build(); }).build(); //Send GET Request and get response Request request = new Request.Builder().url(url).build(); okhttp3.Response response = client.newCall(request).execute(); //Get and print response String responseString = response.body().string(); System.out.println(responseString); } /** * Socks5 proxy */ public static void testSocks5WithOkHttp() throws IOException { //Request URL String url = "http://ipinfo.ipidea.pro"; //Create a SOCKS proxy object and set the actual proxy server host name and port Proxy proxy = new Proxy(Proxy.Type.SOCKS, new InetSocketAddress("host", "port"));//The "host" and "port" used here should be replaced with the proxy server address and port. //Set the global default authenticator (Authenticator) to handle basic authentication required for all network connections. A username and password are preset here java.net.Authenticator.setDefault(new java.net.Authenticator() { private PasswordAuthentication authentication = new PasswordAuthentication("account", "password".toCharArray());//The "account" and "port" here should be replaced with proxy username and proxy password. @Override protected PasswordAuthentication getPasswordAuthentication() }); //Build an OkHttpClient instance and configure the SOCKS proxy OkHttpClient client = new OkHttpClient().newBuilder().proxy(proxy).build(); //Send GET request and get response Request request = new Request.Builder().url(url).build(); okhttp3.Response response = client.newCall(request).execute(); //Get and print response String responseString = response.body().string(); System.out.println(responseString); } }