IPAPI提取说明
IP代理提取API使用说明
接口地址
https://api.zhizhuip.com/public/ip/port/extract请求方式
请求参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
| cty | string | 否 | 地区代码（默认随机） |
| st | string | 否 | 州/省（默认随机） |
| ct | string | 否 | 城市（默认随机） |
| spec | string | 否 | IP池 |
| num | number | 是 | 提取数量，限制范围1~1000 |
| response_type | string | 是 | 数据格式，text（默认），json |
| tm | string | 是 | 有效时间，默认20m（单位：分钟） |
| delimiter | string | 是 | 分隔符，可选值：crlf (\r\n 默认)，lf (\n)，cr (\r)，lb (/br)，tab (\t)，自定义字符 |
参数说明
cty (地区代码)
US（美国）、CN（中国）等。不传此参数则随机分配。st (州/省)
ct (城市)
spec (IP池)
num (提取数量)
response_type (数据格式)
text: 文本格式（默认）json: JSON格式tm (有效时间)
20m（20分钟）。格式：数字 + 单位（m表示分钟）。delimiter (分隔符)
crlf: 回车换行符 \r\n（默认）lf: 换行符 \ncr: 回车符 \rlb: /brtab: 制表符 \t请求示例
示例1：基本请求（随机地区）
https://api.zhizhuip.com/public/ip/port/extract?num=1&response_type=json&delimiter=crlf&tm=20m示例2：指定国家（美国）
https://api.zhizhuip.com/public/ip/port/extract?num=1&response_type=json&delimiter=crlf&cty=US&tm=20m示例3：提取多个IP（文本格式）
https://api.zhizhuip.com/public/ip/port/extract?num=10&response_type=text&delimiter=lf&tm=30m示例4：指定IP池
https://api.zhizhuip.com/public/ip/port/extract?num=5&response_type=json&delimiter=crlf&spec=pool1&tm=20m返回数据格式
返回参数注释
| 名称 | 类型 | 说明 |
|---|---|---|
| list | string[] | API链接集合 |
JSON格式响应（response_type=json）
{
"list": [
"192.168.xxx.xxx",
"192.168.xxx.xxx"
]
}list 字段，list 是一个字符串数组，每个元素是一个IP地址（格式：IP:端口）。文本格式响应（response_type=text）
192.168.xxx.xxx
192.168.xxx.xxxdelimiter 参数指定的分隔符分隔。注意事项
1.
num、response_type、tm、delimiter 为必选参数，缺少任意一个参数可能导致请求失败。2.
num 参数的值必须在 1~1000 之间。3.
tm 参数的单位为分钟（m），例如 20m 表示20分钟，60m 表示60分钟。4.
5.
6.
错误处理
{
"code": 400,
"msg": "参数错误：num参数必填",
"data": null
}400: 参数错误401: 认证失败403: 权限不足500: 服务器错误使用场景
1.
2.
cty 参数获取指定国家的IP代理3.
num 参数一次性提取多个IP代理4.
text 或 json 格式修改于 2025-11-11 09:03:18