## 1 概述 短效代理、独享代理和长效代理通过API获取代理IP后，您就可以在程序里通过代理服务器获取网页数据。 隧道代理无需调用API获取代理，在【[会员中心](https://www.qg.net/user)】查看隧道的IP和端口号，对接隧道服务即可。 独享代理（地区锁）则需要在业务操作列表通过【IP管理】去添加城市线路和拨号IP获取代理IP，并保持城市线路不变。 您获取的代理IP是这样的：`122.96.59.105:23068` `122.96.59.105` 是代理服务器的IP地址； `23068` 是代理服务器的端口号。 ## 2 代理验证 使用短效代理、独享代理和长效代理的IP需要进行授权验证，购买后只有通过您的用户名密码或设置白名单验证后才能使用。 隧道代理则是接入青果隧道服务器即可，隧道服务验证方式同样支持用户名密码（Authkey和Authpwd）和白名单验证； 需要注意的是，白名单的添加需在未提取IP前添加；短效代理产品的不同key，不能添加相同的白名单IP。 我们支持两种验证方式： ### 2.1 绑定您机器的IP作为白名单 如果是办公室电脑，可以访问[https://ip.cn/api/index?ip=&type=0](https://ip.cn/api/index?ip=&type=0)查询您的外网IP； 如果是Linux服务器，可以通过如下命令查看机器外网IP：`curl https://d.qg.net/ip` 进入会员中心，找到您所在的业务，管理【白名单】，包括添加删除白名单，白名单设置详情如下图：   ### 2.2 帐密验证 进入【会员中心】，在您所在的代理IP业务找到用于代理IP验证的用户名密钥信息（Authkey和Authpwd）。  **HTTP代理** 通过用户名密码的进行身份认证，格式如下： ``` curl -x http://{key}:{passwd}@{ip}:{port} {targetUrl} ``` Http/Https代理，-x 填写的协议头只能是Http，不能是Https，如果填写下面那样的格式，将无法访问 ``` curl -x https://{ip}:{port} {targetUrl} ``` **Socks代理** ``` curl -x socks5://{ip}:{port} {targetUrl} ``` curl返回的是未渲染的html内容，这属于正常现象，请参见[代码样例](https://www.qg.net/list/192.html)。 ### 2.3 命令行测试 如果您的程序在Linux上运行，我们非常推荐您在命令行下先通过`curl`命令测试代理服务器的可用性，然后再进行编程。 例如您的用户名是`authkey`，密码是`authpwd`，提取到的代理IP是`118.92.69.112:32105`，IP白名单是`36.90.191.92:32140`，可执行如下命令测试代理可用性： Http/Https代理，帐密模式 ``` curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl} ``` Http/Https代理，白名单模式 ``` curl -x http://{36.90.191.92}:{32140} {targetUrl} ``` ##3 代码样例 - [代码示例 - Java](https://www.qg.net/doc/1698.html "代码示例--Java") - [代码示例 - PHP](https://www.qg.net/doc/1696.html "代码示例--PHP") - [代码示例 - Python](https://www.qg.net/doc/1697.html "代码示例--Python") - [代码示例 - GO](https://www.qg.net/doc/1695.html "代码示例--GO") - [代码示例 - C语言](https://www.qg.net/doc/1694.html "代码示例--C语言")

为了方便新用户更好地了解和使用我们的代理IP产品，我们为新注册用户提供免费试用。 **免费试用规则** **1.适用产品**： 目前代理IP产品除按量提取类型的产品暂不支持试用之外，其他代理产品皆有免费试用机会。 即，可进行免费试用的产品有： 国内代理IP中，按时购买的短效代理/独享代理/隧道代理/长效代理IP，皆有免费试用6小时的套餐。 全球HTTP中，按通道提取的短效代理产品，可选择免费试用2小时。 **2.获取条件** 新用户在注册后完成实名认证，并关注“青果网络”微信公众号，即可获得免费试用资格。 实名认证链接：https://www.qg.net/user/auth/result.html  扫码关注【青果网络QGNET】微信公众号 **3.免费试用次数** 每位完成认证+关注的新用户，都有3次免费试用机会。 用户可在适用产品下任意选择配置，0元下单试用套餐，进行测试使用。  注册通道：[立即注册](https://www.qg.net/register) 免费试用产品传送门： [国内代理 | 短效代理 ＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=1&pool_type=2&extract_mode=4&spec_idx=0&num_idx=0&time_idx=0&number=1000&authkey_type=0) [国内代理 | 独享代理 ＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=2&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=0&number=1&authkey_type=0) [国内代理 | 隧道代理 ＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=3&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=0&number=5&authkey_type=0) [国内代理 | 长效代理 ＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=4&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=0&number=1&authkey_type=0) [全球HTTP | 短效代理 ＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=11&extract_mode=1&spec_idx=0&num_idx=0&time_idx=0&number=1&authkey_type=0)

## 1 API调用提取 对于短效代理、独享代理、长效代理，我们都提供了API接口，方便开发者批量获取代理IP。 接口返回数据的格式支持文本、json、xml。 获取IP接口文档： - [短效代理IP资源提取 ＞](https://www.qg.net/doc/2255.html) - [独享代理IP资源提取 ＞](https://www.qg.net/doc/1840.html) - [长效代理IP资源提取 ＞](https://www.qg.net/doc/1863.html) 隧道代理无需调用API提取代理，其他接口参见：[API接口概览](https://www.qg.net/doc/2145.html) ## 2 生成API链接 你可以在【提取工具】或【调试工具】生成API链接在线提取IP，方便集成到您的程序或软件中。 ### 2.1 提取工具 选择已购买可用的AuthKey值,根据实际需求提取对应的IP，点击【生成链接】获取在线API链接，【打开链接】新窗口打开获取申请成功的IP信息，如下图所示；   ### 2.2 调试工具 首先勾选要进行提取的业务key，key为必选项，是对接接口的必要信息； 其次，选择接口方法，不同的产品可选择的提取接口不同。 短效代理可选择【提取IP资源】、【获取IP池资源】接口，接口【获取IP池资源】是获取IP资源池全部可用的IP，资源池指的是购买短效代理的多通道形成的小资源池； 独享代理提取接口可选择【提取IP资源】、【更换IP资源】，接口【更换IP资源】是释放IP并申请新的IP； 长效代理提取接口可选择【提取IP资源】； 然后，其他选项IP数量、地区、运营商按需选择，最后点击【测试】按钮即可进行IP提取,申请成功返回结果为如下图所示；  ## 3 测试API链接 ### 3.1 浏览器测试 您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接： https://proxy.qg.net/query?Key=0B***607 ###3.2 命令行测试 如果您在linux系统下，可以通过curl命令请求API链接查看结果： ``` curl "https://proxy.qg.net/allocate?Key=请改成您的Key ``` ## 4 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -100 | 计划不存在或已过期 | | -101 | 请求数量超过计划通道数 | | -102 | 没有剩余的可用通道 | | -103 | 资源不足 | | -104 | 资源申请失败 | | -105 | 申请的IP数超过允许申请的IP数 | 每个接口自己的错误码请参见各接口文档。 ## 5 代码样例 - [代码示例-Python](https://www.qg.net/doc/81.html) - [代码示例-Java](https://www.qg.net/doc/82.html) - [代码示例-PHP](https://www.qg.net/doc/83.html)

## 1. 接口描述 接口请求域名： static.proxy.qg.net。 本接口 (/resources) 用于长效代理产品查询资源地区的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data | Array of [ResourceAreaISP](https://www.qg.net/doc/1839.html) | 资源地区列表。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://static.proxy.qg.net/resources?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": [ { "area": "福建省泉州市", "area_code": 350500, "isp": "电信", "isp_code": 1, "available": false }, { "area": "河南省商丘市", "area_code": 411400, "isp": "电信", "isp_code": 1, "available": true } ],     "request_id": "51024a8b-a8a5-4e78-9301-cb500a8c083e" } ``` ## 5. 错误码 | 错误码 | 描述 | | ---------------------- | ------------------------------------------------------------ | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |

## 1. 接口描述 接口请求域名： static.proxy.qg.net。 本接口 (/channels) 用于长效代理产品通道数查询的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------- | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data.toal | Integer | key的通道总数。 | | data.idle | Integer | 空闲通道数。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://static.proxy.qg.net/channels?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": { "total": 10, "idle": 5 }, "request_id": "83158ebe-be6c-40f7-a158-688741083edc" } ``` ## 5. 错误码 | 错误码 | 描述 | | ---------------------- | ------------------------------------------------------------ | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |

## 1. 接口描述 接口请求域名： static.proxy.qg.net。 本接口 (/delete) 是用于长效代理-静态型产品释放IP资源的接口。（动态型无此功能） 默认接口请求频率限制：每通道一周有两次释放机会。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------------------------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | | task | 否 | String | 按提取批次释放。支持批量释放，用逗号隔开。比如：Z5p2DKKCSyhocKEa,xsQGWfoaX99WcYnU。 | | ip | 否 | String | 按IP释放。支持批量释放，用逗号隔开。比如：129.123.7.89,23.11.112.51。 | 注意：task和ip必选其一。如果需要释放全部IP，用task='*'即可。 ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://static.proxy.qg.net/delete?key=<您的key信息>&<其他输入参数> ``` #### 输出示例 ```json { "code": "SUCCESS", "request_id": "83158ebe-be6c-40f7-a158-688741083edc" } ``` ## 5. 错误码 | 错误码 | 描述 | | ------------------------ | -------------------------------------------------------- | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 | | DELETE_LIMIT_EXCEEDED | 释放频率超出限制。 | | STATIC_DELETE_TIME_LIMIT | 静态资源需要24小时后才能释放。 |

## 1. 接口描述 接口请求域名： static.proxy.qg.net。 本接口 (/query) 用于长效代理产品查询在用的IP资源的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------------------------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | | task | 否 | String | 提取批次筛选。支持多批次筛选，用逗号隔开。比如："Z5p2DKKCSyhocKEa,kAEaWHucf8iPXm0O"。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------------------------------------------------- | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data.tasks | Array of [Task](https://www.qg.net/doc/1839.html) | 提取批次列表。
**注：Task结构中的IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** | | data.num | Integer | 提取批次数量。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://static.proxy.qg.net/query?key=<您的key信息>&<其他输入参数> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": { "tasks": { "task_id": "Z5p2DKKCSyhocKEa", "ips": [ { "proxy_ip": "123.54.55.24", "server": "123.54.55.24:59419", "area": "河南省商丘市", "isp": "电信", "deadline": "2023-02-25 15:38:36" } ], "num": 1 }, "num": 1 }, "request_id": "83158ebe-be6c-40f7-a158-688741083edc" } ``` ## 5. 错误码 | 错误码 | 描述 | | ---------------------- | ------------------------------------------------------------ | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |

## 1. 接口描述 接口请求域名： static.proxy.qg.net。 本接口 (/get) 用于长效代理产品提取IP资源的接口。 默认接口请求频率限制：（通道数*5+10）次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------- | ------------------------------------------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | | area | 否 | String | 按地区提取。 | | isp | 否 | Integer | 按运营商提取。
0: 不筛选
1: 电信
2: 移动
3: 联通 | | num | 否 | Integer | 提取个数，默认为1。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ------------ | ----------------------------------------------- | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data.task_id | String | 提取批次的ID。 | | data.ips | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** | | data.num | Integer | 提取到的IP资源数量。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://static.proxy.qg.net/get?key=<您的key信息>&<其他输入参数> ``` #### 输出示例 ```json {     "code": "SUCCESS",     "data": {         "task_id": "0LIKQ3S1_task",         "ips": [             {                 "proxy_ip": "123.54.55.24",                 "server": "123.54.55.24:59419",                 "area": "河南省商丘市",                 "isp": "电信",                 "deadline": "2023-02-25 15:38:36"             }         ],         "num": 1     },     "request_id": "83158ebe-be6c-40f7-a158-688741083edc" } ``` ## 5. 错误码 | 错误码 | 描述 | | ---------------------- | ------------------------------------------------------------ | | INTERNAL_ERROR | 系统内部异常。 | | INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 | | INVALID_KEY | Key不存在或已过期。 | | UNAVAILABLE_KEY | Key不可用，已过期或被封禁 | | ACCESS_DENY | Key没有此接口的权限。 | | API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 | | NO_RESOURCE_FOUND | 资源不足。 | | FAILED_OPERATION | 提取失败。 |

## 1说明 通过编码使用长效代理主要有以下4步骤： 1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口； 2.使用白名单或账密进行授权验证； 3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤") 4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口 长效代理API接口一览 | 接口类型 | API | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | 资源相关 | - [get](https://www.qg.net/doc/product/6_258_274/1863.html)
- [delete](https://www.qg.net/doc/product/6_258_274/1862.html)
- [query](https://www.qg.net/doc/product/6_258_274/1861.html)
- [channels](https://www.qg.net/doc/product/6_258_274/1860.html)
- [resources](https://www.qg.net/doc/product/6_258_274/1859.html)
| - 提取IP资源
- 释放IP资源
- 查询在用IP资源
- 查询通道数
- 查询资源地区
| | 白名单相关 | -[whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |

在当今信息爆炸的时代，舆情监测已成为企业不可或缺的一项重要工作。为了在激烈的市场竞争中立于不败之地，企业必须能够快速、准确地掌握市场动态和消费者反馈。然而，传统的网络IP在频繁的舆情数据采集过程中，往往容易遭遇被封禁或限制的问题，这极大地限制了数据采集的广度和深度。为此，动态IP技术应运而生，为舆情监测提供了全新的解决方案。 ## 一、动态IP技术的优势 动态IP技术最显著的优势在于其能够不断切换IP地址，从而有效规避被目标网站封禁或限制的风险。这意味着企业可以连续、稳定地获取各种网络平台上的舆情信息，无论是社交媒体上的用户评论，还是新闻网站上的相关报道，都能一网打尽。 1. **广泛的IP资源**：覆盖多个国家和地区，满足不同地区的数据采集需求。 2. **稳定性和速度**：保证数据采集的效率和成功率。 3. **易于集成**：能够与企业现有的数据采集工具和平台无缝集成。 ## 二、动态IP在舆情监测中的具体应用 1. **实时洞察舆论风向** 动态IP技术使企业能够实时监测舆情，第一时间了解消费者对其产品或服务的满意度、意见和建议。例如，当一款新产品推出后，企业可以实时跟踪社交媒体上用户的讨论，及时发现潜在问题并采取措施加以解决，从而避免负面舆情的发酵影响品牌形象。 2. **精准分析舆论动态** 借助动态IP技术，企业可以收集到大量的舆情数据，并通过专业的分析工具进行深度挖掘。这些数据可以帮助企业发现消费者的需求偏好、市场趋势等有价值的信息，为企业的决策提供有力支持。 3. **企业形象维护与修复** 当企业面临舆论危机时，动态IP技术能够迅速收集相关舆情信息，帮助企业制定针对性的应对策略。通过及时发布正面信息，引导舆论走向，企业可以将损失降到最低。 ## 三、如何实现全网无死角数据采集 1. **制定合理的采集策略** 在使用动态IP进行数据采集时，企业需要制定一个合理的采集策略。这包括明确数据采集的目标、确定数据采集的频率和时间、以及制定IP轮换策略等。通过合理的采集策略，可以确保数据采集的效率和成功率。 2. **采用先进的采集技术** 除了动态IP技术外，企业还可以采用其他先进的采集技术，如自动化脚本、数据爬虫等。这些技术可以大大提高数据采集的效率和准确性，使企业能够快速获取到所需的舆情信息。 3. **加强数据安全管理** 在数据采集过程中，保护数据安全是非常重要的。企业需要使用加密协议（如HTTPS）确保数据在传输过程中的安全，并遵守相关的数据保护法规和隐私政策。此外，还需要建立完善的数据备份和恢复机制，以防止数据丢失或损坏。 4. **实时监控与优化** 实时监控数据采集过程可以帮助企业及时发现并解决潜在问题。例如，当某个IP地址被目标网站封禁时，企业可以立即切换到其他可用的IP地址，以确保数据采集的连续性。同时，企业还需要定期对采集策略和技术进行优化，以适应不断变化的市场环境。 ## 四、结论 动态IP技术在舆情监测中发挥着至关重要的作用。它不仅能够助力企业实时掌握舆论动态，还能为企业提供精准的分析结果，维护和修复企业品牌形象。在未来的市场竞争中，企业应充分利用动态IP这一强大工具，积极应对舆情的挑战，为自身的发展保驾护航。通过制定合理的采集策略、采用先进的采集技术、加强数据安全管理以及实时监控与优化等措施，企业可以实现全网无死角数据采集，为企业的决策提供有力支持。