Cidade Estados Brasil

API de cidades e estados do Brasil com busca por nome, sigla e DDD. Dados do IBGE com código oficial de município.

原始信息汇总

数据集概述：Cidade Estados Brasil (巴西城市与州 API)

简介
该 API 提供巴西所有 27 个州和 5,571 个市（基于 IBGE 官方数据）的完整地理与行政信息，支持按名称、州代码、DDD 区号等多种方式查询，适用于表单、物流、电话验证和系统集成等场景。

---

核心特性与数据

• 覆盖范围：27 个州（含名称、代码、区域、时区）及 5,571 个市（含名称、所属州、DDD、IBGE 代码、是否为州府）
• 数据来源：IBGE（巴西地理与统计研究所）官方地方数据 + BrasilAPI（DDD 部分），定期更新
• 搜索能力：支持带/无重音、大小写无关的名称匹配；支持按 DDD 区号反向查询城市
• 响应速度：内存缓存架构，典型响应时间低于 10ms；服务器位于巴西圣保罗
• 独特优势：每条记录均包含 IBGE 官方代码（兼容 NF-e、eSocial 等政府系统）、支持 DDD 反向查询、无需对用户输入进行预处理

---

可用端点

方法	端点	描述
GET	/estado/buscarTodosOsEstados	返回所有 27 个州（含名称、代码、区域、时区）
GET	/estado/buscar?sigla=SP	按官方缩写查询州
GET	/estado/buscar?nome=São Paulo	按名称查询州（支持无重音搜索）
GET	/cidade/buscarPorEstado?sigla=SP	返回某个州的所有城市（如 SP 返回 645 个）
GET	/cidade/buscarPorNome?nome=Campinas	按名称查询城市（支持无重音搜索）
GET	/cidade/buscarPorDDD?ddd=11	返回属于某个 DDD 区号的所有城市

---

典型响应示例

州示例
json { "nome": "São Paulo", "sigla": "SP", "regiao": "Sudeste", "fusoHorario": "America/Sao_Paulo", "codigoIBGE": 35, "capital": "São Paulo" }

城市示例
json { "nome": "Campinas", "estado": "SP", "ddd": 19, "codigoIBGE": 3509502, "capital": false }

---

适用场景

• 地址表单中的州-市级联选择
• 巴西电话号码地区归属验证
• 数据库补充 IBGE 官方城市代码
• 物流与配送系统的区域覆盖查询

---

定价方案

方案	月费	特点
BASIC	$0.00	基础免费套餐
PRO	$1.00	升级套餐
ULTRA	$4.00	更高级别
MEGA	$9.00	最高级别

注：API 人气指数 8.6，服务等级 100%，平均延迟 723ms。