CPFHub.io
免费开始

标准查询

发送 CPF（巴西个人税号），即可从 CPFHub.io 数据库获取 姓名、性别 和 出生日期。每查到一个 CPF 消耗 1 个积分。

正在使用 Cursor、Lovable、v0 或其他 AI 工具？ 复制标准查询的提示词，粘贴到您的 AI 助手中。

在 Cursor 中打开

不确定该用哪种查询？请对比各查询方式。

端点

GEThttps://api.cpfhub.io/cpf/{cpf}

参数

位置名称必填说明
路径cpf是带或不带格式的 CPF：12345678909 或 123.456.789-09
请求头x-api-key是您的 API 密钥。见身份认证。

示例

示例从 CPFHUB_API_KEY 读取密钥，将 404 视为正常结果，并设置 10 秒超时。其他语言见各语言示例。

curl --max-time 10 "https://api.cpfhub.io/cpf/12345678909" \
  -H "x-api-key: $CPFHUB_API_KEY"

响应

HTTP 200 OK

JSON
{
  "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
  }
}
字段类型说明
data.cpfstring查询的 CPF，11 位数字，不带格式
data.namestring全名。可能为大写，比对时请使用 nameUpper
data.nameUpperstring大写全名
data.gender"M" | "F" | null性别。数据库中无此信息时为 null
data.birthDatestring出生日期，DD/MM/YYYY
data.day, data.month, data.yearnumber出生日期的日、月、年

错误

API 只返回葡萄牙语信息。错误信息按原样列出，首次出现时在括号内附中文释义。

状态码触发场景处理方式
400CPF 不是 11 位数字修正 CPF。不要重试。
401API 密钥缺失、无效或已停用（error 为字符串）检查 x-api-key 请求头。
403积分已用完且未开通超额用量（error.message："Limite de créditos excedido"，积分额度已超出），或账户已停用/封禁（error 为字符串）补充积分或联系支持团队。不要重试。
404数据库中未查到该 CPF正常结果。不消耗积分。
422校验位错误修正 CPF。不要重试。
429超出每分钟限制（默认 30 次/分钟）等待 Retry-After 请求头给出的秒数。不消耗积分。
500, 503临时故障按递增间隔重试（2 秒、4 秒、8 秒）。不消耗积分。

错误格式、重试策略以及如何在不消耗积分的情况下测试，见错误码。每分钟限制和积分规则见使用限制。

补充说明

  • 费用： 每查到一个 CPF（200）消耗 1 个积分。部分套餐有单独的费用，请在控制台查看您套餐的费用。
  • 响应时间： 建议设置约 10 秒的超时。
  • 客户端超时： 查询可能已在服务器端完成并计费。重试会再次计费。
  • 示例数据： CPF 12345678909 及上方数据均为虚构。

更新于 2026 年 10 月 4 日