• 来源：星月代理 https://www.xydaili.net/
  • 浏览：3065

IP提取接口文档

高效稳定的代理IP提取API，支持多种协议和地区选择

接口地址

GET http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI

提取接口一次调用按你指定的数量、城市、运营商返回可用的代理 IP。请求必须带 action（GetAPI 或 GetIP）和 OrderNumber；默认返回文本，加 split=json 返回结构化 JSON。

请求参数说明

参数名称 含义 是否必填 取值范围
action 接口动作 否 不传或 GetIP 都是提取 IP；在线提取页生成的链接用 GetAPI
OrderNumber 订单号 是 32 位订单号，会员中心「我的订单」里复制，等同凭证请勿泄露
qty 提取数量 否 1-200，默认 1；建议一次取 5~20 条，超上限返回 202/506
protocol 协议类型 否 1: HTTP/HTTPS（默认）
3: SOCKS5
Area 指定城市 否 如 南京；留空表示不限地区，一次只能指定一个城市
Isp 指定运营商 否 如 电信、联通、移动
ips 运营商筛选（本地池） 否 0: 不限（默认）
1: 电信
2: 联通
3: 移动
不额外调用上游、响应更快
poolIndex 线路池序号 否 0: 优质A池（默认）
1: 优质B池
2: 优质C池
单线路账号保持 0
dt 线路参数 否 线路特定（如去重模式开关），直接用在线提取页生成的链接即可
split 返回格式 / 分隔符 否 json: 结构化 JSON
\n、\r、\r\n、\t: 文本分隔符
Cache 缓存复用 否 设为 1 开启：缓存窗口内重复调用返回同一批 IP，适合需要固定出口的连续请求
Cachetimems 缓存窗口 否 毫秒，配合 Cache=1，如 60000 表示一分钟内复用同一批 IP
bufferTime 最短剩余有效期 否 秒，只返回剩余有效期大于该值的 IP，如 60 可避免拿到即将失效的 IP
endTime 最长剩余有效期 否 秒，只返回剩余有效期不超过该值的 IP，用于控制轮换节奏

请求示例

http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=10&protocol=1
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&Area=南京&Isp=电信
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&split=json
http://api.xydaili.net:2022/tools/ip.ashx?action=GetAPI&OrderNumber=你的订单号&qty=5&ips=1

把示例里的 OrderNumber 换成你自己的订单号即可直接测试；接口是 HTTP（不要写成 https），单条循环提取很容易触发 406 限流。

返回格式

文本模式（split 留空或指定分隔符）

113.75.1.20:51008
112.84.36.17:42913

每行一条，格式为 IP:端口；账号密码模式的线路为 IP:端口:用户名:密码，把这一串直接填进爬虫的代理配置即可。

JSON 模式（split=json）

{
  "status": 200,
  "msg": "成功",
  "QTY": 2,
  "leftTime": "1天02小时",
  "leftIp": "998(剩余量)",
  "data": [
    {
      "ip": "113.75.1.20",
      "port": "51008",
      "city": "南京",
      "isp": "电信",
      "expire": "2026-09-26T09:39:53",
      "outip": "",
      "userName": "",
      "pwd": ""
    },
    {
      "ip": "112.84.36.17",
      "port": "42913",
      "city": "南京",
      "isp": "电信",
      "expire": "2026-09-26T09:41:20",
      "outip": "",
      "userName": "",
      "pwd": ""
    }
  ]
}

状态码说明

200 - 成功
正常返回；注意 QTY=0 表示本次没有可用 IP
401 - 请求参数不正确
缺 OrderNumber、参数拼写错误或订单号不存在
304 - 订单已到期
订单有效期已过，续费或重新购买
204 - 套餐已过期
套餐周期结束，续费后即可继续提取
208 - 数量已用完
计量/去重计量套餐的可用量耗尽，可看 leftIp 提前预警
205 - 套餐提取数量已达到上限
达到套餐提取上限，可联系客服确认能否扩量
206 - 暂无可用 IP
该城市/运营商当前资源紧张或池子正在轮换，换城市或去掉城市限制
406 - 提取频率过快
短时间大量调用，改成批量提取（qty=10~20）并拉开间隔
202 - 单次请求数量超出最大值
降低 qty，分多次提取
506 - 提取数量大于单次提取最大数
线路侧限制更严格，同样降低单次数量
203 - 白名单个数限制
白名单已满，删掉不用的条目或升级套餐
207 - 提取机器超出服务范围
检查是否用代理去调接口，改用直连或把出口 IP 加入白名单
436 - 代理 IP 未经授权或已超出使用时长
重新提取一条新的 IP
504 - 代理 IP 状态异常
换一条 IP；连续出现联系客服
505 - 代理 IP 节点异常
换城市或稍后重试

完整对照表见 状态码与错误码对照表；先看 status，再按建议动作，基本不用问客服。

使用建议

  • 缓存设置： 既要频繁提取又要固定出口的，用 Cache=1&Cachetimems=60000 在一分钟内复用同一批 IP
  • 提取数量： 根据实际需要设置提取数量，避免资源浪费
  • 错误处理： 请正确处理API返回的错误代码，确保程序稳定性
  • 频率限制： 短时间大量调用会返回 406，建议改成批量提取（qty=10~20）再用本地小池子补货