短效优质代理 (纯生版) - 获取代理IP的API接口
站大爷
官方
2026-05-15
请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。
建议每隔10秒一次调用，以及时获取更新的代理IP。
注意：接口返回的代理服务器的IP地址并非实际出口IP，若需要返回实际出口IP，需要在控制台的API接口设置里进行设置。
1 接口说明
| 属性 | 内容 |
|---|---|
| URL | http://{该实例的提取服务器域名}:8080/GetIP/ |
| 方法 | GET POST |
| 编码 | utf-8 |
| 参数说明 | inst_id：实例ID；akey：实例的akey，由该实例的密码通过16位MD5加密得出；count(必填)：提取数量, 不能超过该实例的"单次提取限量"；adr(可选)：ip的地理位置筛选关键词，多关键词以半角逗号隔开，字符串使用UrlEncode编码；dedup(必填)：过滤今日已提取过的IP，1表示"是"，0表示"否"；timespan(必填)：IP剩余存活时间，赋值范围为1-5，比如3，表示3-6分钟，注意选择最低存活时间越长，连续提取结果中的IP重复率可能越高；type：返回类型，1表示"Text文本"，2表示"JSON"，3表示"Xml"。 |
| 响应 | 返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制； 类型为 Text文本的定制标签如下：{ip}：代理服务器地址；{port}：代理端口；{adr}：地理位置；{out_ip}：实际出口IP；{expired_seconds}：预计剩余存活时间(秒)；{is_new_dedup}：是否新增不重复IP。类型为 JSON或Xml格式的响应字段如下：code：错误编号；msg：描述信息；data：数据体；count：代理IP数量；proxy_list：代理IP列表；ip：代理服务器地址；port：代理端口；adr：地理位置；out_ip：实际出口IP；expired_seconds：预计剩余存活时间(秒)；is_new_dedup：是否新增不重复IP。 |
| 错误编号 | 10001：获取成功；12001：akey错误；12002：调用频率过快，1秒内最多只能调用10次；12003：参数不完整或有错误；12004：该实例不存在或已过期；12005：该实例已过期；12006：该实例已被冻结或禁用；12007：该实例尚未设置IP白名单；12008：该实例已被限制；12009：该参数条件下当前没有任何代理IP；12019：该设备尚未被授权调用本API接口。 |
2 接口示例
请求：
GET /GetIP/?inst_id=1234567890&akey=8a17ca305f683620&count=5&dedup=0×pan=1&type=2 HTTP/1.1
Host: {该实例的提取服务器域名}响应：
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Thu, 25 Apr 2019 10:46:56 GMT
Content-Length: 381
{
"code": "10001",
"msg": "获取成功，本次提取增加了5个不重复的新IP，今日还可以再提取4985个不重复的IP",
"data": {
"count": 5,
"dedup_count": 5,
"today_left_count": 4985,
"proxy_list": [
{
"ip": "36.157.252.96",
"port": 10822,
"out_ip": "122.233.221.168",
"adr": "中国–浙江–杭州 电信",
"expired_seconds": 292,
"is_new_dedup": 1
},
{
"ip": "36.157.252.96",
"port": 11765,
"out_ip": "123.156.146.84",
"adr": "中国–浙江–金华 联通",
"expired_seconds": 145,
"is_new_dedup": 1
},
{
"ip": "36.157.252.96",
"port": 10334,
"out_ip": "116.1.241.77",
"adr": "中国–广西–南宁 电信",
"expired_seconds": 135,
"is_new_dedup": 1
},
{
"ip": "36.157.252.96",
"port": 11960,
"out_ip": "112.38.201.67",
"adr": "中国–山东–聊城 移动",
"expired_seconds": 131,
"is_new_dedup": 1
},
{
"ip": "36.157.252.96",
"port": 10983,
"out_ip": "112.47.244.110",
"adr": "中国–福建–泉州–安溪县 移动",
"expired_seconds": 158,
"is_new_dedup": 1
}
]
}
}
