本页目录
一、前置结论：巨量 IP 全系列 HTTP 代理完整支持 API 提取
1. 短效动态 HTTP 代理：专属 RESTful 提取 API，每次调用获取全新一次性 IP，是爬虫批量采集主流方案；
2. 独享静态 HTTP：配套查询 API，可批量导出全部静态节点 IP、账号、端口；
3. 住宅隧道代理：无需频繁拉取 IP，固定网关地址，但配套余额、白名单查询辅助 API；
4. 兼容所有开发场景：Python、Java、PHP、curl、指纹浏览器、分布式爬虫集群定时拉取 IP 池；
5. 接口无隐性限流，千线程并发稳定，全国 320 + 城市地域筛选、自定义单次提取数量。
二、API 接口后台生成完整操作步骤（必做前置配置）
步骤 1：登录后台，进入动态 HTTP 订单
左侧菜单栏【动态代理 / 短效 HTTP 代理】，找到已充值 / 开通的按量订单，点击右侧【生成提取链接】按钮。
步骤 2：添加设备白名单（接口调用失败 90% 源于未授权）
1. 提取页面点击【修改白名单】；
2. 系统自动识别当前电脑外网 IP，一键快速添加；
3. 多台服务器、多开发设备可批量录入，单订单最多支持 5 台设备同时调用 API；
4. 未添加白名单直接请求 API 会返回 403 无权限报错。
步骤 3：自定义 API 提取核心参数（按需配置）
| 参数项 | 可选值 | 商用建议配置 |
| num（提取数量） | 1~50 | 单脚本单次 1\5 条；分布式集群 20\50 条 |
| pt（代理协议） | 1=HTTP/HTTPS | 固定填 1 |
| result_type（返回格式） | text/json/xml | 爬虫程序选 json；浏览器手动复制选 text |
| split（分隔符） | 1 换行 / 2 逗号 | json 格式无需修改 |
| area（地域筛选） | 省市代码 / 全国随机 | 本地采集填城市；全域抓取不填 |
全部参数设置完成，点击【生成 API 链接】，系统生成带交易单号、加密签名的永久接口地址，妥善保存链接，无需重复生成。
步骤 4：API 接口有效性验证
复制生成的完整链接粘贴至浏览器地址栏访问：
• 正常返回：展示多条 IP: 端口：账号：密码文本 / JSON 数组；
• 报错返回：根据提示补充白名单、调整提取数量、检查订单余额。
三、核心 API 接口总览（官方原生接口）
1. 核心提取接口（dynamic/getips）
用途：批量获取全新短效 HTTP 代理 IP，每次调用 IP 不重复复用
基础地址模板：
http://v2.api.juliangip.com/dynamic/getips?num=1&pt=1&result_type=json&trade_no=订单号&sign=加密签名
2. 辅助运维配套 API
1. dynamic/balance：查询订单剩余提取额度、余额；
2. dynamic/getwhiteip：查询当前订单已授权设备白名单；
3. dynamic/setwhiteip：代码远程添加服务器 IP 白名单；
4. dynamic/remain：查询 IP 存活时长、线路连通率统计。
四、多语言完整调用代码示例
示例 1：Python requests 标准调用（JSON 格式，爬虫首选）
| python # 安装依赖：pip install requests import requests import json # 替换为你后台生成的完整API链接 API_URL = "http://v2.api.juliangip.com/dynamic/getips?num=5&pt=1&result_type=json&trade_no=xxx&sign=xxx" def get_http_proxy_list(): try: resp = requests.get(API_URL, timeout=12) data = resp.json() proxy_arr = data["proxy_list"] proxy_pool = [] for item in proxy_arr: ip = item["ip"] port = item["port"] user = item["user"] pwd = item["pwd"] proxy_str = f"http://{user}:{pwd}@{ip}:{port}" proxies = { "http": proxy_str, "https": proxy_str } proxy_pool.append(proxies) return proxy_pool except Exception as e: print("API调用失败：", str(e)) return [] # 测试执行 if __name__ == "__main__": pool = get_http_proxy_list() print("获取到代理池：", pool) |
示例 2：Python Text 文本格式简易提取
| python import requests api_url = "你的API链接&result_type=text" res = requests.get(api_url).text.strip() # 按行分割多条IP proxy_lines = res.split("\n") for line in proxy_lines: ip, port, user, pwd = line.split(":") proxy = f"http://{user}:{pwd}@{ip}:{port}" print(proxy) |
示例 3：curl 命令调用（服务器 Linux 环境快速测试）
| bash curl "http://v2.api.juliangip.com/dynamic/getips?num=1&pt=1&result_type=json&trade_no=xxx&sign=xxx" |
示例 4：隧道配套（无需频繁 API，固定网关）
隧道代理不需要循环调用提取 API，直接使用固定网关配置：
| python import requests proxies = { "http": "http://隧道账号:隧道密码@网关地址:端口", "https": "http://隧道账号:隧道密码@网关地址:端口" } headers = {"Connection": "close"} resp = requests.get("https://httpbin.org/ip", proxies=proxies, headers=headers) print(resp.json()) |
五、API 调用规范与并发限制（避坑核心）
1. 请求频率限制
单订单每秒 API 请求不超过 5 次，高频循环拉取会返回 429 限流错误，大量采集建议缓存 IP 池，减少接口调用频次；
2. 单次提取上限
num 参数最大 50，如需上千 IP 分多批次循环请求，不建议单次拉满；
3. IP 生命周期规则
API 获取的短效 HTTP IP 一次性使用，过期失效，不支持重复复用；
4. 分布式集群调用
多台服务器同时调用同一 API，需全部服务器外网 IP 加入白名单；
5. 地域参数规范
城市代码与后台地区选择栏一一对应，填写错误会返回全国随机 IP。
六、API 常见报错与解决方案
1. 403 禁止访问
原因：服务器 IP 未添加白名单；处理：后台【修改白名单】添加对应设备外网 IP；
2. 429 请求过于频繁
原因：短时间循环调用 API；处理：增加 time.sleep 延迟，本地缓存 IP 池减少拉取；
3. 返回空列表
原因：订单额度耗尽 / 所选城市无空闲节点；处理：充值余额或更换全国随机线路；
4. 接口超时
原因：服务器网络波动；处理：代码增加 timeout 超时捕获，自动重试 2 次；
5. 签名 sign 失效
原因：修改后台提取参数后未重新生成 API 链接；处理：重新配置参数，生成全新接口地址。
七、分场景 API 使用方案
场景 1：小规模 Python 爬虫（日请求 1 万内）
选用 num=1 单次提取单条 IP，请求失败自动重新调用 API 换新 IP，极简脚本无需维护本地大 IP 池。
场景 2：工作室多线程批量采集
num=20~50 批量拉取 IP 存入 Redis 缓存，循环消费缓存内代理，降低 API 请求次数，提升效率。
场景 3：指纹浏览器多环境自动化
后台生成 text 格式 API 链接，指纹浏览器 IP 池面板填入接口地址，软件定时自动调用刷新 IP 列表。
场景 4：企业分布式千线程集群
1. 生成大容量提取 API，num=50 批量拉取；
2. 调用 balance 接口定时监控订单余额，低于阈值预警充值；
3. 多业务分组使用独立订单与独立 API 链接，避免 IP 交叉污染。
场景 5：7×24 小时不间断监测业务
优先选用住宅隧道代理，放弃频繁 API 提取，仅用固定网关地址，减少接口运维开发量。
八、API 提取方案总结
巨量 IP 短效 HTTP 代理具备成熟稳定的官方 API 提取接口，支持自定义地域、提取数量、多格式返回，适配 Python、Linux、自动化工具全场景。
短期海量批量采集业务，直接生成专属 API 链接循环拉取全新 IP；长期持续监测业务优先隧道代理，简化代码无需频繁调用接口。
调用前务必完成白名单授权、控制请求频率，搭配缓存机制减少 API 请求次数，可实现高稳定、低损耗的商用爬虫 IP 池自动化管理。采购前可申领免费测试额度，生成测试 API 接口验证业务兼容性。
FAQ 常见问题
1. 独享静态 HTTP 代理有没有 API？
有，后台静态订单支持 API 批量导出全部静态 IP、账号、端口信息，适合多账号隔离采集。
2. API 提取的 IP 会不会重复分配？
短效动态 IP 接口采用用完即销毁机制，短时间内不会重复分配同一 IP，IP 复用率低于 1%。
3. 同一 API 链接可以多台服务器同时调用吗？
可以，但所有服务器外网 IP 必须全部添加至订单白名单，否则会 403 报错。
4. API 链接长期使用会失效吗？
只要订单有效、参数不修改，API 永久有效；修改提取参数后需要重新生成新链接。