您将获得
一万个 CNPJ， 一个请求。
队列、并发和重试由我们负责。您只需提交列表并跟踪进度。
每批最多 10,000 个 CNPJ
整份列表通过一次 POST 提交，立即返回 jobId。重复项会被去除，每个 CNPJ 只查询一次、只计费一次。
处理期间即可查看部分结果
每次查询状态都会显示已处理的 CNPJ 数量和已完成的记录，无需等待批次结束。
字段与 CNPJ 查询一致
每个查到的 CNPJ 都返回完整登记信息：法定名称、登记状态、CNAE、地址和股东列表。未查到的 CNPJ 返回 found: false。
razao_socialsituacao_cadastralcnae_principalmunicipioufQSA用表格，不写代码
在控制台上传 CSV 或 TXT 文件，或直接粘贴列表。系统自动识别 CNPJ 列，结果导出为可直接用 Excel 打开的 CSV。
支持任意编程语言集成
两步完成：先提交 CNPJ 清单，再查询批次结果。只需 HTTP。
# 第 1 步：提交 CNPJ 清单
curl -X POST "https://api.cpfhub.io/cnpj/bulk" \
-H "x-api-key: YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{"cnpjs": ["11222333000181", "12ABC34501DE35"]}'
# → 202 Accepted { "jobId": "4a1ef25e-052c-4464-..." }
# 第 2 步：等待状态变为 "done"
curl "https://api.cpfhub.io/cnpj/bulk/4a1ef25e-052c-4464-9657-4148f53bb0fc" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"data": {
"id": "4a1ef25e-052c-4464-9657-4148f53bb0fc",
"status": "done",
"total_records": 2,
"processed": 2,
"found": 1,
"not_found": 1,
"skipped": 0,
"error": null,
"cnpjs": [
{
"cnpj": "11222333000181",
"found": true,
"data": {
"cnpj": "11222333000181",
"razao_social": "EMPRESA EXEMPLO LTDA",
"situacao_cadastral": "Ativa",
"cnae_principal": "6201501",
"uf": "SP",
"municipio": "SAO PAULO"
}
},
{
"cnpj": "12ABC34501DE35",
"found": false,
"data": null
}
]
}
}每月 50 个免费积分，无需信用卡。
进度跟踪
批次进展到哪一步， 您始终清楚。
三种状态，五个计数器。批次是在运行、已完成还是已中断，一目了然。
processing
批次正在运行。查询状态会返回进度和已查询的 CNPJ。
done
批次已完成。响应中每个 CNPJ 对应一条结果，查到的 CNPJ 附带完整登记信息。
failed
批次已中断。error 字段说明原因，只有已查到的 CNPJ 会被计费。
批次计数器
total_records进入批次的有效且不重复的 CNPJ 数量。
processed已完成查询的数量。
found数据集中存在的数量。这是您需要付费的部分。
not_found没有记录的数量。不收费。
skipped因处理过程中余额用尽而被跳过的数量。
应用场景
当列表 太长的时候。
逐个核验 CNPJ 需要好几天，现实中没人会这么做。
供应商清理
在下一轮付款之前，找出哪些供应商已关闭、不适格或已暂停。
B2B 客户组合
更新整个客户组合的法定名称、地址和 CNAE，并找出已经关闭的公司。
ERP 或 CRM 迁移
在把记录迁移到新系统之前，确认哪些 CNPJ 存在，并完成数据标准化。
定期客户组合复核
每月运行一次批量查询，查看哪些客户的登记状态、规模或 Simples Nacional（巴西简易税制）选择发生了变化。
按 CNAE 和地区细分
按经营活动、规模、州和城市对企业列表分组，用于规划销售和服务。
收购尽职调查
接手了另一家公司的客户群？批量查询能告诉您有多少 CNPJ 仍在存续，无需逐个人工核对。
计费
只为存在的 CNPJ 付费。
老旧列表中常有输错、重复或从未存在的 CNPJ。在这里，这些都不消耗积分。
1 个积分
每个查到的 CNPJ，与单次查询相同
R$ 0
每个未查到、无效或重复的 CNPJ（巴西雷亚尔）
10,000
每批 CNPJ 上限，批次数量不限
在不含超额用量的套餐中，只有余额足以覆盖全部有效 CNPJ 时，批次才会被接受。如果处理过程中余额用尽，剩余的 CNPJ 会以 skipped 返回，不查询也不收费。
常见 问题
每批可以查询多少个 CNPJ？
每次请求最多 10,000 个。更长的列表请拆分成多个分块，每块提交一个批量任务。系统会自动去重，每个 CNPJ 只查询和计费一次。
可以上传表格吗？
可以。在 CPFHub.io 控制台的“查询”中选择 CNPJ 批量查询，上传 CSV 或 TXT 文件，或直接粘贴列表。CNPJ 列会自动识别，结果可下载为 CSV。暂不支持 XLSX 文件，请先将表格另存为 CSV 再上传。
CNPJ 批量查询的价格是多少？
每个查到的 CNPJ 消耗 1 个积分，与单次查询相同，使用同一套餐余额，包括免费版每月的 50 个积分。未查到、无效或重复的 CNPJ 不消耗积分，查询批量任务状态也不消耗积分。
每个 CNPJ 返回哪些数据？
与 CNPJ 查询的记录相同：法定名称、商号、登记状态、主营和次要 CNAE、法律性质、地址、联系方式、企业规模、注册资本、Simples Nacional 和 MEI 选择，以及股东名单，自然人股东的 CPF 经过掩码处理。控制台导出的 CSV 包含主要字段。
如何通过 API 使用批量查询？
在 POST /cnpj/bulk 中以请求体 {"cnpjs": [...]} 提交 CNPJ。API 返回 202 和 jobId。调用 GET /cnpj/bulk/{jobId} ，直到状态为 done 或 failed。任务运行期间，响应中已包含部分结果。
批量任务进行中余额用尽会怎样？
在不支持超额用量的套餐中，只有余额足以覆盖全部有效 CNPJ 时才接受批量任务。如果处理过程中余额用尽，剩余的 CNPJ 以 skipped 返回，不查询也不计费。充值后只需提交剩余部分。
数据多久更新一次？
数据来自巴西联邦税务局（Receita Federal）发布的 CNPJ 公开数据集，每月更新。批量查询不会实时查询联邦税务局：每条记录反映最新的月度数据集。
批量查询支持字母数字 CNPJ 吗？
支持。列表中可以混合数字和字母数字 CNPJ，带或不带格式符号均可。处理前会验证校验位，无效的 CNPJ 会被排除，不收取费用。