ISO 3166 Country Subdivisions API

Complete ISO 3166-2 database — administrative subdivisions (regions, states, provinces, districts) for 250+ countries, filterable by country, type, and name with full pagination support.

原始信息汇总

ISO 3166 Country Subdivisions API 数据集详情

数据集概述

该API提供对完整 ISO 3166-2 标准的结构化访问，涵盖ISO 3166-1下所有国家的主要行政区划代码，包括地区、州、省、区、县、州、省辖市等，覆盖 250多个国家。

核心功能

• 按国家列出所有行政区划：一次调用获取某国的全部行政区划，可按类型（地区、省、州、区等）筛选。
• 通过ISO 3166-2代码查询行政区划：根据代码（如IT-MI、US-CA、DE-BY）直接查找具体行政区划，用于验证和丰富数据。
• 筛选与分页列表查询：跨所有国家同时查询，支持按国家代码、行政区划类型和名称关键词筛选，每次请求最多返回 1,000条 结果。
• 类型索引：发现数据集中存在的所有行政区划类型，按频率排序，适用于构建动态筛选界面。
• 国家索引：列出数据集中所有国家及其行政区划数量，便于填充附带数据覆盖信息的国家选择器。

数据字段结构

字段	类型	描述
country_code	string	ISO 3166-1 alpha-2 国家代码（如 IT、US、DE）
subdivision_code	string	ISO 3166-2 行政区划代码（如 IT-MI、US-CA、DE-BY）
name	string	官方行政区划名称
type	string	行政区划类型（如 region、state、province）

行政区划类型示例

类型	示例国家
region	意大利、法国、西班牙
state	美国、巴西、澳大利亚、印度
province	加拿大、中国、南非
district	英国、瑞士、奥地利
department	法国、哥伦比亚
canton	瑞士
prefecture	日本

可通过 GET /types 接口获取完整类型列表。

典型用例

• 具有动态地区/州/省下拉菜单的地址表单
• 地理定位和区域验证管道
• 需要标准化行政区划代码的CRM和ERP系统
• 基于区域配送规则的物流平台
• 合规与监管工具（增值税、管辖区域映射）
• 国际数据集的数据标准化
• 政府和公共部门数据基础设施

定价方案

• BASIC：$0.00/月（免费版）
• PRO：$9.00/月
• ULTRA：$19.00/月
• MEGA：$45.00/月

快速入门示例

• 获取意大利所有地区：GET /country/IT?type=region
• 查询特定行政区划：GET /subdivision/US-CA
• 跨所有国家按名称搜索：GET /?q=bavaria&limit=10
• 列出国家及行政区划数量：GET /countries

分页说明

• 支持 limit 和 offset 参数，最大 limit 为 1,000，默认值为 100。
• 示例：GET /?country_code=DE&limit=50&offset=0