免费版
可真正用于测试的免费巴西 CPF 查询 API
每月 50 个积分，无需信用卡。CPF 即巴西个人税号。适合 MVP 和集成测试。用量超出免费版后，Pro 版每月 R$ 19（巴西雷亚尔）起。
API 返回的数据
全名、性别（M/F）和出生日期。另含 nameUpper 字段，以及拆分为 day、month、year 的日期字段。
不按秒限流
标准查询默认每分钟 30 次请求（每个批量任务计为 1 次），实时查询每分钟 5 次，定制套餐可调整。用量由每月积分额度控制。免费版可用性 SLA 为 95%。
免费版积分用尽返回 403
免费版不支持超额用量。余额为 0 时调用 GET /cpf 返回 403（“Limite de créditos excedido”，API 返回的葡萄牙语提示，意为积分额度已用尽）。
几分钟拿到文档和 API 密钥
创建账户，将密钥填入 x-api-key 请求头，调用 GET /cpf/{cpf} 即可。文档和示例可直接使用。
示例
一次 GET 请求，返回完整 JSON
使用 x-api-key 请求头。Base URL 为 https://api.cpfhub.io ，URL 中不含版本号。
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "Fulano de Tal",
"nameUpper": "FULANO DE TAL",
"gender": "M",
"birthDate": "15/06/1990",
"day": 15,
"month": 6,
"year": 1990
}
}常见问题
常见 问题
免费版包含多少次查询？
免费版每月包含 50 个积分。查到 CPF 的标准查询（HTTP 200）消耗 1 个积分，实时查询消耗 1.5 个积分。未查到的 CPF（404）以及格式或校验位错误的 CPF（400/422）不消耗积分。积分不结转到下月。
需要信用卡吗？
不需要。免费版无需信用卡。在 app.cpfhub.io 创建账户，生成 API 密钥，即可开始查询 CPF。
积分用完会怎样？
免费版不支持超额用量，GET /cpf 会返回 403，提示信息为“Limite de créditos excedido”。批量查询中余额不足的条目标记为 skipped。开启超额用量的套餐会继续查询，超额部分计入下一个计费周期。详情见 /zh/pricing。
免费版有 SLA 吗？
有。可用性 SLA 因套餐而异：免费版 95%，Pro 版 99%，企业版 99.9%。详见 /zh/pricing。批量查询的耗时取决于提交的 CPF 数量。
还有疑问？
联系我们