地区查询

查询代理服务支持的国家、州/省、城市信息，用于精准选择代理位置。通过层级查询（国家→州/省→城市），帮助你获取特定地区的代理资源。

接口列表

接口	方法	描述
获取国家列表	GET	获取所有支持的国家及代理数量
获取州/省列表	GET	获取指定国家的州/省信息
获取城市列表	GET	获取指定州/省的城市信息

获取国家列表

获取所有支持的国家及其可用代理数量。

接口信息

项目	说明
接口地址	`https://api.ipflex.ink/token/list/area/countries`
请求方法	`GET`
认证方式	Bearer Token（从后台获取）

请求参数

参数名	类型	必填	说明	示例
`search_text`	string	否	搜索关键词（国家名称）	`United`
`page`	integer	否	页码，默认 1	`1`
`page_size`	integer	否	每页数量，默认 10，最大 100	`20`
`is_static`	boolean	否	是否筛选静��代理	`true`
`is_traffic`	boolean	否	是否筛选流量代理	`false`
`is_datacenter`	boolean	否	是否筛选数据中心代理	`false`
`by`	string	否	来源标识	`api`

请求示例

cURLPython

bash

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.ipflex.ink/token/list/area/countries?page=1&page_size=20"

python

import requests

headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.get(
    'https://api.ipflex.ink/token/list/area/countries',
    headers=headers,
    params={
        'page': 1,
        'page_size': 20
    }
)

print(response.json())

响应示例

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "data": [
      {
        "id": 233,
        "name": "United States",
        "code": "US"
      }
    ]
  }
}

响应字段说明

字段	类型	说明
`code`	integer	状态码，0表示成功
`msg`	string	响应消息
`data.data`	array	国家列表
`data.data[].id`	integer	国家 ID（用于后续查询州/省）
`data.data[].name`	string	国家英文名称
`data.data[].code`	string	国家代码（ISO 3166-1 alpha-2）

获取州/省列表

获取指定国家下的州/省信息及其可用代理数量。

接口信息

项目	说明
接口地址	`https://api.ipflex.ink/token/list/area/state`
请求方法	`GET`
认证方式	Bearer Token（从后台获取）

请求参数

参数名	类型	必填	说明	示例
`parent_id`	integer	是	国家 ID（从获取国家列表接口获取）	`1`
`search_text`	string	否	搜索关键词（州/省名称）	`California`
`page`	integer	否	页码，默认 1	`1`
`page_size`	integer	否	每页数量，默认 10，最大 100	`20`
`is_static`	boolean	否	是否筛选静态代理	`true`
`is_traffic`	boolean	否	是否筛选流量代理	`false`
`is_datacenter`	boolean	否	是否筛选数据中心代理	`false`
`by`	string	否	来源标识	`api`

提示

parent_id 使用从获取国家列表接口返回的国家 ID。

请求示例

cURLPython

bash

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.ipflex.ink/token/list/area/state?parent_id=1&page=1&page_size=20"

python

import requests

headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.get(
    'https://api.ipflex.ink/token/list/area/state',
    headers=headers,
    params={
        'parent_id': 1,
        'page': 1,
        'page_size': 20
    }
)

print(response.json())

响应示例

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "data": [
      {
        "id": 1456,
        "name": "Alabama",
        "code": "AL",
        "name_with_underlined": "alabama",
        "name_with_none": "alabama"
      },
      {
        "id": 1400,
        "name": "Alaska",
        "code": "AK",
        "name_with_underlined": "alaska",
        "name_with_none": "alaska"
      },
      {
        "id": 1416,
        "name": "California",
        "code": "CA",
        "name_with_underlined": "california",
        "name_with_none": "california"
      }
    ]
  }
}

响应字段说明

字段	类型	说明
`code`	integer	状态码，0表示成功
`msg`	string	响应消息
`data.data`	array	州/省列表
`data.data[].id`	integer	州/省 ID（用于后续查询城市）
`data.data[].name`	string	州/省英文名称
`data.data[].code`	string	州/省代码
`data.data[].name_with_underlined`	string	下划线格式名称
`data.data[].name_with_none`	string	无格式名称

获取城市列表

获取指定州/省下的城市信息及其可用代理数量。

接口信息

项目	说明
接口地址	`https://api.ipflex.ink/token/list/area/city`
请求方法	`GET`
认证方式	Bearer Token（从后台获取）

请求参数

参数名	类型	必填	说明	示例
`parent_id`	integer	是	州/省 ID（从获取州/省列表接口获取）	`1`
`search_text`	string	否	搜索关键词（城市名称）	`Los Angeles`
`page`	integer	否	页码，默认 1	`1`
`page_size`	integer	否	每页数量，默认 10，最大 100	`20`
`is_static`	boolean	否	是否筛选静态代理	`true`
`is_traffic`	boolean	否	是否筛选流量代理	`false`
`is_datacenter`	boolean	否	是否筛选数据中心代理	`false`
`by`	string	否	来源标识	`api`

提示

parent_id 使用从获取州/省列表接口返回的州/省 ID。

请求示例

cURLPython

bash

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.ipflex.ink/token/list/area/city?parent_id=1&page=1&page_size=20"

python

import requests

headers = {
    'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.get(
    'https://api.ipflex.ink/token/list/area/city',
    headers=headers,
    params={
        'parent_id': 1,
        'page': 1,
        'page_size': 20
    }
)

print(response.json())

响应示例

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "data": [
      {
        "id": 110968,
        "name": "Abbeville",
        "code": "",
        "name_with_underlined": "abbeville",
        "name_with_none": "abbeville"
      },
      {
        "id": 111032,
        "name": "Adamsville",
        "code": "",
        "name_with_underlined": "adamsville",
        "name_with_none": "adamsville"
      },
      {
        "id": 112358,
        "name": "Birmingham",
        "code": "",
        "name_with_underlined": "birmingham",
        "name_with_none": "birmingham"
      }
    ]
  }
}

响应字段说明

字段	类型	说明
`code`	integer	状态码，0表示成功
`msg`	string	响应消息
`data.data`	array	城市列表
`data.data[].id`	integer	城市 ID（用于创建代理时指定城市）
`data.data[].name`	string	城市英文名称
`data.data[].code`	string	城市代码（通常为空）
`data.data[].name_with_underlined`	string	下划线格式名称
`data.data[].name_with_none`	string	无格式名称

地区查询 ​

接口列表 ​

获取国家列表 ​

接口信息 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段说明 ​

获取州/省列表 ​

接口信息 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段说明 ​

获取城市列表 ​

接口信息 ​

请求参数 ​

请求示例 ​

响应示例 ​

响应字段说明 ​

相关文档 ​

地区查询

接口列表

获取国家列表

接口信息

请求参数

请求示例

响应示例

响应字段说明

获取州/省列表

接口信息

请求参数

请求示例

响应示例

响应字段说明

获取城市列表

接口信息

请求参数

请求示例

响应示例

响应字段说明

相关文档