获取当前可用国家和地区

按 国家 → 州/省 → 城市 层级返回当前可用地区，并在国家、州级别提供质量与规模评级，便于按需筛选目标地区。无需登录，可直接请求。

接口说明

本页文档对应新接口 areas2。相对旧版扁平列表接口，新增树形结构，以及 successLevel（成功率评级）、ipCountLevel（IP 数量评级）。

接口描述

项目	说明
方法	GET
地址	https://api2.ipmart.io/ipmart/common/areas2
认证	无需认证
Content-Type	application/json

完整示例：

https://api2.ipmart.io/ipmart/common/areas2

输入参数

无。

返回结构说明

data 为对象，主要字段：

参数名称	类型	描述
upTime	Long	数据更新时间（毫秒时间戳）
countryList	Array	国家列表

层级关系：

data
└─ countryList[]          # 国家
   ├─ successLevel        # 成功率评级（国家支持）
   ├─ ipCountLevel        # IP 数量评级（国家支持）
   └─ stateList[]         # 州 / 省
      ├─ successLevel     # 成功率评级（州支持）
      └─ cityList[]       # 城市（无评级字段）

国家字段（countryList[]）

参数名称	类型	描述
code	String	国家代码（如 US、AE）
cntry	String	国家英文名
cntryName	String	国家中文名
successLevel	Int	成功率评级，5–1（见下方说明）
ipCountLevel	Int	IP 数量评级，5–1（见下方说明）
stateList	Array	该国下属州 / 省列表

州 / 省字段（stateList[]）

参数名称	类型	描述
state	String	州 / 省代码或英文标识（用于请求参数）
stateName	String	州 / 省展示名
successLevel	Int	成功率评级，5–1（州级别支持）
cityList	Array	该州下属城市列表

说明

州级别仅提供 successLevel，不提供 ipCountLevel。

城市字段（cityList[]）

参数名称	类型	描述
city	String	城市代码或英文标识（用于请求参数）
cityName	String	城市展示名

城市级别不提供成功率 / IP 数量评级。

评级说明

successLevel（成功率评级）

数值越大表示成功率越高：

等级	含义
5	成功率 95%+
4	成功率 90%+
3	成功率 80%+
2	成功率 70%+
1	成功率 70% 以下

适用层级：国家、州/省。

ipCountLevel（IP 数量评级）

数值越大表示可用 IP 规模越大：

等级	含义
5	100000+ IP
4	10000+ IP
3	1000+ IP
2	100+ IP
1	100 以下 IP

适用层级：仅国家。

使用建议

• 若有需求，可按 successLevel、ipCountLevel 筛选所需质量的国家和州。
• 实时在线规模总览也可参考 实时在线IP数。

返回示例

成功

以下为截取示例（真实返回包含全部国家 / 州 / 城市）：

{
  "status": 200,
  "data": {
    "upTime": 1789219531759,
    "countryList": [
      {
        "code": "AE",
        "cntry": "United Arab Emirates",
        "cntryName": "阿拉伯联合酋长国",
        "successLevel": 5,
        "ipCountLevel": 4,
        "stateList": [
          {
            "state": "Abudhabi",
            "stateName": "Abudhabi",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Abudhabi",
                "cityName": "Abudhabi"
              },
              {
                "city": "Alain",
                "cityName": "Alain"
              }
            ]
          },
          {
            "state": "Dubai",
            "stateName": "Dubai",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Dubai",
                "cityName": "Dubai"
              }
            ]
          }
        ]
      },
      {
        "code": "US",
        "cntry": "United States",
        "cntryName": "美国",
        "successLevel": 5,
        "ipCountLevel": 5,
        "stateList": [
          {
            "state": "California",
            "stateName": "California",
            "successLevel": 5,
            "cityList": [
              {
                "city": "Losangeles",
                "cityName": "Losangeles"
              },
              {
                "city": "Sanfrancisco",
                "cityName": "Sanfrancisco"
              }
            ]
          }
        ]
      }
    ]
  }
}