Skip to main content
GET
按国家/地区获取城市目录

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

查询参数

country
string
必填

ISO 3166-1 alpha-2 国家/地区代码(例如 US)。

Pattern: ^[A-Z]{2}$

响应

按行政区划分组的城市列表(国家/地区无覆盖时为空列表)。

country
string

原样返回的 ISO 3166-1 alpha-2 国家/地区代码。

states
object

按 ISO 3166-2 行政区划代码(<CC>-<code>)分组的城市。

country_cities
string[]

无法映射到行政区划的城市。

meta
object

覆盖统计(state_countcity_count)。

最后修改于 2026年8月22日