巴西公司查询与信息丰富化 API

API ID 12794

巴西官方公司数据通过CNPJ:超过40个字段 股东(QSA) CNAE 联系人和一个0-100的注册评分 单字段请求 批量最多1,000个CNPJ

100% 正常运行时间 5,461 ms 平均响应

API 文档

端点

请求
返回每个有效的CNPJ所对应的一个丰富的公司资料。发送一个字段(cnpjs),包含一个或最多1,000个巴西公司税号,可以是格式化或仅数字。每个资料包括40多个字段:法定和商业名称、注册状态和日期、CNAE活动、完整地址、电话、电子邮件、注册资本、公司规模、股东名册(QSA)和一个0-100的注册评分,用于潜在客户和风险优先级。无效的CNPJ将在本地验证并被跳过
Endpoint ID: 25146
POST https://zylalabs.com/api/12794/brazil+company+lookup+and+enrichment+api/25146/company+enrichment
输入参数

公司充实 — 端点功能

对象 描述
请求体 必需 Json

剩余免费测试请求:3 / 3。


输入参数

API 示例响应
JSON
[{"cnpj":"00000000000191","cnpjFormatado":"00.000.000/0001-91","matriz":true,"consultadoEm":"2026-06-06T04:20:37.382Z","scoreCadastral":100,"razaoSocial":"BANCO DO BRASIL SA","nomeFantasia":"Direcao Geral","naturezaJuridica":"2038","naturezaJuridicaDescricao":"Sociedade de Economia Mista","capitalSocial":"120000000000.00","capitalSocialNumerico":120000000000,"porte":"05","porteDescricao":"Demais","enteFederativo":"Uniao","situacaoCadastral":"02","situacaoCadastralDescricao":"Ativa","dataSituacaoCadastral":"2005-11-03","dataInicioAtividade":"1966-08-01","cnaePrincipal":{"codigo":"6422-1/00","descricao":"Bancos multiplos, com carteira comercial"},"cnaesSecundarios":[{"codigo":"6499-9/99","descricao":"Outras atividades de servicos financeiros nao especificadas anteriormente"}],"logradouro":"Quadra Saun Quadra 5 Bloco B Torre I, II, III","numero":"SN","complemento":"Andar T I Sl S101 a S1602","bairro":"Asa Norte","cep":"70040912","uf":"DF","municipioCodigo":"5300108","municipioNome":"Brasilia","pais":"76","paisDescricao":"Brasil","telefone1":"6134939002","telefone2":null,"email":"[email protected]","enderecoCompleto":"Quadra Saun Quadra 5 Bloco B Torre I, II, III, SN, Asa Norte, Brasilia/DF, CEP 70040-912","idadeEmpresaAnos":59,"idadeEmpresaDias":21859,"tempoSituacaoAtualDias":7520,"totalSocios":42,"totalCnaesSecundarios":1,"tempoMedioSociosDias":1087,"socios":[{"nome":"Tarciana Paula Gomes Medeiros","tipo":"2","tipoDescricao":"Pessoa Fisica","documento":"***128734**","qualificacao":"16","qualificacaoDescricao":"Presidente","dataEntrada":"2023-01-26","faixaEtariaDescricao":"41-50"},{"nome":"Marcelo Henrique Gomes da Silva","tipo":"2","tipoDescricao":"Pessoa Fisica","documento":"***263598**","qualificacao":"10","qualificacaoDescricao":"Diretor","dataEntrada":"2024-12-30","faixaEtariaDescricao":"41-50"}],"simples":null,"simei":null,"inscricoesEstaduais":[],"suframa":[]},{"cnpj":"33000167000101","cnpjFormatado":"33.000.167/0001-01","matriz":true,"consultadoEm":"2026-06-06T04:25:02.297Z","scoreCadastral":100,"razaoSocial":"PETROLEO BRASILEIRO S A PETROBRAS","nomeFantasia":"Petrobras - Edise","naturezaJuridica":"2038","naturezaJuridicaDescricao":"Sociedade de Economia Mista","capitalSocial":"205431960490.52","capitalSocialNumerico":205431960490.52,"porte":"05","porteDescricao":"Demais","enteFederativo":"Uniao","situacaoCadastral":"02","situacaoCadastralDescricao":"Ativa","dataSituacaoCadastral":"2005-11-03","dataInicioAtividade":"1966-09-28","cnaePrincipal":{"codigo":"0600-0/01","descricao":"Extracao de petroleo e gas natural"},"cnaesSecundarios":[{"codigo":"1921-7/00","descricao":"Fabricacao de produtos do refino de petroleo"},{"codigo":"3520-4/01","descricao":"Producao de gas; processamento de gas natural"}],"logradouro":"Avenida Republica do Chile","numero":"65","complemento":null,"bairro":"Centro","cep":"20031170","uf":"RJ","municipioCodigo":"3304557","municipioNome":"Rio de Janeiro","pais":"76","paisDescricao":"Brasil","telefone1":"2121660000","telefone2":null,"email":"[email protected]","enderecoCompleto":"Avenida Republica do Chile, 65, Centro, Rio de Janeiro/RJ, CEP 20031-170","idadeEmpresaAnos":59,"idadeEmpresaDias":21801,"tempoSituacaoAtualDias":7520,"totalSocios":9,"totalCnaesSecundarios":5,"tempoMedioSociosDias":773,"socios":[{"nome":"Magda Maria de Regina Chambriard","tipo":"2","tipoDescricao":"Pessoa Fisica","documento":"***612937**","qualificacao":"16","qualificacaoDescricao":"Presidente","dataEntrada":"2024-06-07","faixaEtariaDescricao":"61-70"},{"nome":"Claudio Romeo Schlosser","tipo":"2","tipoDescricao":"Pessoa Fisica","documento":"***077120**","qualificacao":"10","qualificacaoDescricao":"Diretor","dataEntrada":"2023-04-17","faixaEtariaDescricao":"61-70"}],"simples":null,"simei":null,"inscricoesEstaduais":[],"suframa":[]}]
公司充实 — 代码片段

curl --location --request POST 'https://zylalabs.com/api/12794/brazil+company+lookup+and+enrichment+api/25146/company+enrichment' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{"cnpjs": ["00.000.000/0001-91", "33.000.167/0001-01"]}'

    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 巴西公司查询与信息丰富化 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。

(年度计费可节省 2 个月 🎉)

🚀 企业版套餐

起价
$ 10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

将任何巴西CNPJ(公司税号)转化为来自官方Receita Federal登记的完整结构化公司档案,涵盖超过5500万家公司

每次查找返回40多个字段:法定和贸易名称、注册状态和日期、股本、公司规模、法律性质、主要和次要CNAE活动代码及说明、完整地址、电话和电子邮件、公司年龄指标、完整的股东董事会(QSA)及其角色和入职日期,以及一个专有的0-100注册评分(scoreCadastral)用于即时潜在客户和风险优先级排序

为金融科技入职、KYB和预KYC检查、CRM丰富(HubSpot、Salesforce、Pipedrive)、潜在客户资格和合规流程而构建。请求方式简单:一个字段(cnpjs)可包含一个或最多1000个CNPJ。无效的CNPJ会被本地验证并跳过

为什么选择这个API:大多数CNPJ端点返回基本的登记卡。这个API增加了股东董事会、联系方式、派生指标(公司年龄、董事会稳定性)和即用的评分,这些字段实际上推动了入职和信贷决策

巴西公司查询与信息丰富化 API FAQs

CNPJ是官方的14位税号,用于识别巴西注册的每家公司,类似于美国的EIN。您可以以格式化的方式发送(00.000.000/0001-91)或仅以数字发送(00000000000191)。两者都可以,API会自动规范化输入。

是的 API 返回巴西法律规定的公司注册数据 这些信息与官方政府渠道提供的信息相同 股东的个人文件会以掩码形式返回 与公共注册中的公布内容完全一致 典型的合规用例包括 KYB 供应商入职 信用分析 CRM 增强和 B2B 线索资格认证

是的 cnpj 字段接受一个列表,因此您可以在一个请求中发送一个单独的 CNPJ 或一批 CNPJ 例如 00.000.000/0001-91 和 33.000.167/0001-01 一起 响应是一个包含每个有效 CNPJ 的一个丰富的配置文件的数组 这是丰富 CRM 列表或潜在客户数据库的推荐方式

每个CNPJ在任何查找之前都将使用官方检验位算法进行本地验证 无效条目将被简单跳过并且不会出现在响应数组中 而同一批中的有效条目将正常处理 一行错误永远不会中断整个请求 这使得大批处理作业具有韧性

每家公司超过40个领域,包括法律和贸易名称 注册状态和日期 股本 公司规模 CNAE活动代码 完整地址 电话 邮箱 公司年龄指标 完整股东董事会和0到100的注册评级

所有注册数据都来自于由巴西联邦税务局维护的官方巴西联邦公司注册处,涵盖了超过5500万家公司,通过持续同步的数据层提供服务。每个响应都包括一个时间戳,显示何时检索到该资料

每个端点为每个有效的CNPJ返回一个全面的公司资料,包括超过40个字段,如法定名称和商号、注册状态、股本、公司规模、联系信息和专有注册分数

关键字段包括CNPJ 法定名称 商业名称 注册状态 股本 企业规模 主要和次要CNAE代码 完整地址 联系详情 股东会议QSA 和注册评分 0到100

响应被结构化为一个 JSON 对象数组,每个对象代表一个有效 CNPJ 的丰富档案。每个档案包含多个字段,便于解析和集成到应用程序中

该端点提供详细的公司信息,包括法律状态、财务指标、股东信息、联系方式和活动分类,所有信息均来源于官方的 Receita Federal 注册。

数据准确性通过直接从官方巴西联邦公司注册处获取信息来确保,该注册处持续更新。在处理之前,每个CNPJ都在本地进行验证以最小化错误

典型的用例包括金融科技的引入 KYB 验证 CRM 的丰富 潜在客户的评分和合规流动使企业能够基于可靠的企业数据做出明智的决策

用户可以利用详细的公司资料进行风险评估、潜在客户优先级排序和合规性检查 注册评分有助于快速识别高质量的潜在客户或潜在风险

用户可以期待一致的数据模式,如企业详细信息的结构化字段,并在活跃和非活跃状态之间有明确的区分 每个响应将包含一个时间戳以确保数据检索的相关性

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API


您可能还喜欢