CNPJ API

实时使用巴西CNPJ号码搜索和检索详细的公司数据
通过 MCP 从您的 AI 代理使用此 API
支持 OpenClaw、Claude Code/Desktop、Cursor、Windsurf、Cline 以及任何兼容 MCP 的 AI 客户端。
文档和设置
通过封装此 MCP 创建技能: https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY

CNPJ查询API允许开发人员使用CNPJ(全国法人登记号)轻松检索在巴西注册的公司信息。它提供即时访问公司名称、商号、注册状态、地址、成立日期、业务活动等企业数据。

该API非常适合入职流程、欺诈预防、B2B服务或丰富商业数据库,帮助您快速高效地验证巴西公司。

只需发送CNPJ号码,即可获取结构化的JSON数据,包含可靠和最新的公共记录。

用例包括:
- 注册期间的商业验证
- 企业KYC(了解您的客户)
- 财务入职自动化
- CRM数据库丰富

API 文档

端点


带或不带标点的CNPJ号码(建议仅使用数字)



                                                                            
GET https://www.zylalabs.com/api/8386/cnpj+api/14654/cnpj
                                                                            
                                                                        

CNPJ - 端点功能

对象 描述
cnpj [必需] CNPJ number
测试端点

API 示例响应

       
                                                                                                        
                                                                                                                                                                                                                                                                                                                                        {
    "api": {
        "success": true,
        "tempo": "233ms",
        "tipo": "real_time"
    },
    "data": {
        "uf": "SP",
        "cep": "06454070",
        "qsa": [
            {
                "pais": null,
                "nome_socio": "DORIVAL PEREIRA DE OLIVEIRA JUNIOR",
                "codigo_pais": null,
                "faixa_etaria": "Entre 61 a 70 anos",
                "cnpj_cpf_do_socio": "***768478**",
                "qualificacao_socio": "Diretor",
                "codigo_faixa_etaria": 7,
                "data_entrada_sociedade": "2020-11-23",
                "identificador_de_socio": 2,
                "cpf_representante_legal": "***000000**",
                "nome_representante_legal": "",
                "codigo_qualificacao_socio": 10,
                "qualificacao_representante_legal": "Não informada",
                "codigo_qualificacao_representante_legal": 0
            },
            {
                "pais": null,
                "nome_socio": "ROGERIO DE MORAES BARREIRA",
                "codigo_pais": null,
                "faixa_etaria": "Entre 51 a 60 anos",
                "cnpj_cpf_do_socio": "***175578**",
                "qualificacao_socio": "Presidente",
                "codigo_faixa_etaria": 6,
                "data_entrada_sociedade": "2021-05-03",
                "identificador_de_socio": 2,
                "cpf_representante_legal": "***000000**",
                "nome_representante_legal": "",
                "codigo_qualificacao_socio": 16,
                "qualificacao_representante_legal": "Não informada",
                "codigo_qualificacao_representante_legal": 0
            }
        ],
        "cnpj": "42591651000143",
        "pais": null,
        "email": null,
        "porte": "DEMAIS",
        "bairro": "ALPHAVILLE INDUSTRIAL",
        "numero": "253",
        "ddd_fax": "1141969800",
        "municipio": "BARUERI",
        "logradouro": "AMAZONAS",
        "cnae_fiscal": 5611203,
        "codigo_pais": null,
        "complemento": "",
        "codigo_porte": 5,
        "razao_social": "ARCOS DOURADOS COMERCIO DE ALIMENTOS SA",
        "nome_fantasia": "",
        "capital_social": 442788930,
        "ddd_telefone_1": "1141969800",
        "ddd_telefone_2": "",
        "opcao_pelo_mei": null,
        "codigo_municipio": 6213,
        "cnaes_secundarios": [
            {
                "codigo": 4763601,
                "descricao": "Comércio varejista de brinquedos e artigos recreativos"
            },
            {
                "codigo": 5611201,
                "descricao": "Restaurantes e similares"
            },
            {
                "codigo": 7740300,
                "descricao": "Gestão de ativos intangíveis não-financeiros"
            },
            {
                "codigo": 8211300,
                "descricao": "Serviços combinados de escritório e apoio administrativo"
            }
        ],
        "natureza_juridica": "Sociedade Anônima Fechada",
        "regime_tributario": [
            {
                "ano": 2015,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2016,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2017,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2018,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2019,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2020,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2021,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2022,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            },
            {
                "ano": 2023,
                "cnpj_da_scp": null,
                "forma_de_tributacao": "LUCRO REAL",
                "quantidade_de_escrituracoes": 1
            }
        ],
        "situacao_especial": "",
        "opcao_pelo_simples": null,
        "situacao_cadastral": 2,
        "data_opcao_pelo_mei": null,
        "data_exclusao_do_mei": null,
        "cnae_fiscal_descricao": "Lanchonetes, casas de chá, de sucos e similares",
        "codigo_municipio_ibge": 3505708,
        "data_inicio_atividade": "1977-01-17",
        "data_situacao_especial": null,
        "data_opcao_pelo_simples": null,
        "data_situacao_cadastral": "2005-11-03",
        "nome_cidade_no_exterior": "",
        "codigo_natureza_juridica": 2054,
        "data_exclusao_do_simples": null,
        "motivo_situacao_cadastral": 0,
        "ente_federativo_responsavel": "",
        "identificador_matriz_filial": 1,
        "qualificacao_do_responsavel": 16,
        "descricao_situacao_cadastral": "ATIVA",
        "descricao_tipo_de_logradouro": "ALAMEDA",
        "descricao_motivo_situacao_cadastral": "SEM MOTIVO",
        "descricao_identificador_matriz_filial": "MATRIZ"
    }
}
                                                                                                                                                                                                                    
                                                                                                    

CNPJ - 代码片段


curl --location --request GET 'https://zylalabs.com/api/8386/cnpj+api/14654/cnpj?cnpj=42591651000143' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 CNPJ API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
标头
标头 描述
授权 [必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

简单透明的定价

无长期承诺。随时升级、降级或取消。

🚀 企业版

起价
$ 10,000/年


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

客户喜爱的功能

  • ✔︎ 仅支付成功请求
  • ✔︎ 7 天免费试用
  • ✔︎ 多语言支持
  • ✔︎ 一个 API 密钥,所有 API。
  • ✔︎ 直观的仪表板
  • ✔︎ 全面的错误处理
  • ✔︎ 开发者友好的文档
  • ✔︎ Postman 集成
  • ✔︎ 安全的 HTTPS 连接
  • ✔︎ 可靠的正常运行时间

CNPJ API FAQs

CNPJ API返回详细的公司信息,包括公司名称、商标名称、注册状态、地址、开业日期、经营活动和合伙人详细信息。此数据采用JSON格式结构化,便于集成

响应中的关键字段包括“uf”(州) “cep”(邮政编码) “qsa”(合作伙伴信息)和“success”状态 每个合作伙伴条目包含姓名 年龄范围 和资格状态的详细信息

响应以JSON格式构造,顶层有一个表示成功和响应时间的"api"对象,后面是一个包含公司详情和合作伙伴数组(qsa)的"data"对象

该API提供公司注册的信息,包括法律状态、地址、业务活动以及合作伙伴和代表的详细信息,适合用于KYC和业务验证

CNPJ API 从巴西官方公共记录中获取其数据,确保高准确性。定期进行更新和检查以维护数据的完整性和可靠性

典型用例包括在入职时验证公司合法性 进行KYC检查 自动化财务入职流程 以及用准确的公司信息丰富CRM数据库

用户可以通过发送CNPJ号码来定制请求,带或不带标点。API旨在处理这两种格式,但建议仅使用数字以获得最佳结果

如果结果部分或为空,用户应验证CNPJ号码的准确性。此外,他们可以检查公司是否是新注册的,或者公共记录中是否存在临时数据问题

CNPJ API允许您检索各种公司详细信息,包括法定名称、商号、注册状态、地址、开业日期、商业活动以及有关合伙人和代表的信息,例如他们的姓名和资格

是的 CNPJ API 涵盖了所有巴西州(UFs)的公司数据 每个响应都包含州信息 使您能够识别注册公司的位置

CNPJ API的响应时间通常在响应的“tempo”字段中指示。这个值反映了处理请求和返回数据所需的时间,通常以毫秒为单位

为了确保准确性,请始终提供一个有效的无标点符号的CNPJ号码。这有助于API有效处理您的请求,并减少收到部分或空结果的可能性

“qsa”字段包含一系列合作伙伴信息,详细说明每位合作伙伴的姓名、年龄范围、资格状态以及进入公司的日期。这对于理解所有权结构至关重要

CNPJ API以JSON格式返回数据,这是一种广泛用于API响应的格式这种结构化格式使得解析和将数据集成到应用程序中变得容易

如果您遇到错误,请检查CNPJ号码的准确性并确保格式正确。如果问题仍然存在,请查阅API文档以获取故障排除提示或联系支持以获取帮助

合作伙伴信息可以用于多种目的,例如进行尽职调查、验证所有权以及在KYC流程或财务评估中评估企业的信誉

一般常见问题

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 秒直到限制重置。

是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。

您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。

7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。

当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。

付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。


相关 API


您可能还喜欢