# 代理IP池

**请求方式:** GET|POST

**接口地址:** https://api.hk0.cc/api/proxypool

**接口描述:** 免费代理IP池:多来源自动采集并实时验证可用性,提供随机可用代理(HTTP/HTTPS/SOCKS),支持按类型、国家/地区、匿名度、最低成功率、最少成功次数筛选,支持延迟/成功率排序与分页,输出 JSON 或纯文本。返回字段含延迟、国家/地区、网络、匿名度、成功与失败次数、成功率、最近校验时间以及是否 stale(最近校验超过 1 小时)。支持 ETag 协商缓存与 CORS,可用 /api/health 做健康检查。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| action | get | query | 可选 | — | — | 操作:get 获取随机可用代理(默认);list 分页列表;stats 统计信息;health 健康检查;openapi 接口规范 |
| type |  | query | 可选 | http | — | 代理类型:http / https / socks / socks4 / socks5 / all,默认 all |
| count |  | query | 可选 | 10 | — | 返回数量 1-100,默认 1;超过 100 会截断并返回 truncated=true |
| format | json | query | 可选 | — | — | 输出格式:json / txt(action=get 时可用),默认 json |
| country |  | query | 可选 | 中国 | — | 按国家/地区过滤(匹配 country 字段,如「中国」「美国」),默认不过滤 |
| page | 1 | query | 可选 | — | — | 分页页码,action=list 时可用,默认 1 |
| limit | 20 | query | 可选 | — | — | 每页数量 1-100,action=list 时可用,默认 20 |
| sort |  | query | 可选 | speed | — | 排序字段:speed 延迟 / score 或 success 成功率 / updated 最近更新 / id,默认 speed |
| anon |  | query | 可选 | elite | — | 匿名级别过滤:elite 高匿 / anonymous 匿名 / transparent 透明,默认不过滤 |
| min_score |  | query | 可选 | 0.5 | — | 最低成功率 0-1,按 success/(success+fail) 计算,默认不过滤 |
| min_success |  | query | 可选 | 3 | — | 最少历史成功次数,默认不过滤 |
| q |  | query | 可选 | 香港 | — | 关键词,匹配地址、国家、地区、网络,action=list 时可用 |
| order |  | query | 可选 | desc | — | 排序方向:asc / desc,默认 asc,action=list 时可用 |

## 返回示例

```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "count": 1,
    "list": [
      {
        "ip": "1.2.3.4",
        "port": 8080,
        "type": "http",
        "protocol": "http",
        "speed": 320,
        "country": "中国",
        "location": "广东 · 深圳",
        "network": "中国电信",
        "success": 12,
        "fail": 0,
        "last_verify": "2026-11-14 10:39:23"
      }
    ]
  }
}
```