Brazil Data Hub API (ou Brazil Logistics & Geo Hub)

PI de geolocalização, cálculo de frete logístico complexo e inteligência demográfica (IBGE) do Brasil com latência sub-5ms.

原始信息汇总

Brazil Data Hub API (Brazil Logistics & Geo Hub) 数据集概述

基本信息

• API名称: Brazil Data Hub API (ou Brazil Logistics & Geo Hub)
• 类别: Location
• 当前版本: 1.0
• 流行度: 8.6
• 服务等级: 100%
• 延迟: 32ms
• 测试状态: 100%
• 提供商: kaique Oliveira Antonio

定价计划

• BASIC: $0.00 / 月
• PRO: $29.00 / 月

核心描述

Brazil Data Hub 是巴西最完整的地理、物流和社会经济数据 API。通过单一端点，系统可以：定位 CEP、计算到目的地的运费并了解该地区的经济概况——所有操作延迟均低于 5ms，无需 webhooks、队列或等待。

技术基础

• 基于 SQLite + FTS5 构建。
• 本地索引了 905,000+ 个地址。
• 地理搜索零依赖外部 API。

主要功能模块与端点

1. 地理定位 (Geolocalização)

• GET /v1/address/{cep}: 通过 CEP 获取完整地址 + GPS（典型延迟 < 1ms）。
• GET /v1/address/search: 搜索街道 (FTS5)（典型延迟 < 5ms）。
• GET /v1/cities/{ibge}: 通过 IBGE 代码获取城市信息（典型延迟 < 1ms）。
• GET /v1/cities/search: 搜索城市 (FTS5)（典型延迟 < 5ms）。

2. 物流与运费 (Logística e Frete)

• GET /v1/freight/cep: 计算两个 CEP 之间的完整运费（典型延迟 ~50-200ms）。

3. 人口统计智能 (Inteligência Demográfica)

• GET /v1/demographics/city/{ibge}: 通过 IBGE 代码获取完整指标（典型延迟 < 1ms）。
• GET /v1/demographics/cep/{cep}: CEP → IBGE → 指标 + 洞察（典型延迟 < 3ms）。

关键特性与竞争优势

• CEP 延迟: < 1ms。
• 离线工作: 支持。
• 运费计算: 原生支持。
• 人口统计数据: 包含 IBGE 数据。
• 按名称搜索: 支持 FTS5 容错搜索。
• GPS 坐标: 包含。
• 速率限制: 100 次请求/分钟。

主要用例

1. 电子商务——购物车运费报价: 实时计算配送成本。
2. 商业扩张——销售点验证: 在签订租赁合同前了解区域经济潜力。
3. 金融科技——信用分析增强: 用城市数据为申请人提供风险背景。
4. CRM/ERP——地址自动填充与增强: 快速表单填写，返回完整地址、GPS 坐标和 IBGE 代码。
5. 市场营销——地理定位细分: 识别经济特征与产品兼容的区域。
6. 物流——TMS 和路线优化: 为不同类型的货物计算取货成本。

智能搜索 (FTS5)

搜索机制接受变体、缩写和部分术语。例如：

• juan amad 可找到 Rua Juan Amador Oliver Perez。
• av paulista 可找到 Avenida Paulista。
• sao lourenco 可找到 São Lourenço do Turvo。

分页参数

所有搜索端点都支持一致的分页：

?q=lins&uf=SP&page=1&limit=20

认证

所有请求（除 /health 外）必须包含以下请求头：

• x-rapidapi-proxy-secret: <seu-segredo-rapidapi>
• x-rapidapi-host: brazil-data-hub.p.rapidapi.com

响应代码

• 200: 成功。
• 400: 参数无效。
• 403: 认证无效。
• 404: CEP 或 IBGE 在数据库中未找到。
• 422: CEP 存在但无 GPS 坐标。
• 429: 超出请求限制。
• 500: 内部错误。

建议计划

• Free: 500 次请求/月，仅地理定位，适用于测试和原型。
• Basic: 10,000 次请求/月，地理定位 + 人口统计，适用于初创公司和 MVP。
• Pro: 100,000 次请求/月，包含运费在内的所有功能，适用于电子商务和 SaaS。
• Ultra: 无限请求，所有功能 + SLA，适用于企业和 TMS。

数据覆盖与更新

• 覆盖巴西所有 5,570 个城市和 905,000+ 个带 CEP 的地址。
• 地理数据源自巴西邮政 (Correios) 数据，建议在邮政每次更新（通常每季度）后重新生成数据库。

支持与资源

• GitHub Issues: https://github.com/kaique-oliveira/brazil-data/issues
• 代码仓库: https://github.com/kaique-oliveira/brazil-data
• 交互式 Swagger: https://brazil-data-hub.fly.dev/api/docs
• OpenAPI JSON: https://brazil-data-hub.fly.dev/api/docs-json