API de Empresas (CNPJ)
Fluxo completo para integrar com a API pública da CNPJData usando autenticação via X-API-Key.
Passo 1 — Comprar créditos
Acesse o painel da CNPJData, vá até a seção API e adquira créditos de API.
Passo 2 — Gerar chave de API
No painel autenticado, na aba Minha API, gere sua chave. Use-a no header X-API-Key nas requisições públicas.
X-API-Key: <id>.<secret>Passo 3 — Consultar 1 empresa por CNPJ
Exemplo de requisição:
curl -X GET "https://api.cnpjdata.com.br/api/companies/01234567000189" \
-H "X-API-Key: <id>.<secret>"Importante: envie sempre o CNPJ sem máscara, apenas números (exemplo: 01234567000189).
Resposta (formato real retornado pela API):
{
"searchId": "uuid-da-busca",
"cnpjCompleto": "01.234.567/0001-89",
"razaoSocial": "EMPRESA EXEMPLO COMERCIO LTDA",
"nomeFantasia": "LOJA EXEMPLO",
"naturezaJuridicaCodigo": "2135",
"porteEmpresaCodigo": "01",
"situacaoCadastralCodigo": "02",
"cnaeFiscalPrincipalCodigo": "4781400",
"cnaeFiscalSecundariaCodigo": "4755502,4772500,4782201,4761003",
"codMunicipio": "4729",
"matrizFilialCodigo": "1",
"logradouro": "RUA EXEMPLO 1",
"numero": "100",
"complemento": "LOJA 01",
"bairro": "CENTRO",
"cep": "01000000",
"uf": "MG",
"telefone1": null,
"telefone2": null,
"email": null,
"dataInicioAtividade": "1997-01-21T00:00:00.000Z",
"dataSituacaoCadastral": "2005-11-03T00:00:00.000Z",
"anoInicio": 1997,
"naturezaJuridicaRef": {
"codigo": "2135",
"descricao": "Empresário (Individual)"
},
"porteEmpresaRef": {
"codigo": "01",
"descricao": "Micro Empresa"
},
"situacaoCadastralRef": {
"codigo": "02",
"descricao": "Ativa"
},
"cnaeRef": {
"codigo": "4781400",
"descricao": "Comércio Varejista De Artigos Do Vestuário E Acessórios"
},
"municipioRef": {
"codigo": "4729",
"descricao": "Jordania"
},
"matrizFilialRef": {
"codigo": "1",
"descricao": "Matriz"
},
"cnaesSecundarios": [
{
"codigo": "4755502",
"descricao": "Comercio Varejista De Artigos De Armarinho"
},
{
"codigo": "4761003",
"descricao": "Comércio Varejista De Artigos De Papelaria"
},
{
"codigo": "4772500",
"descricao": "Comércio Varejista De Cosméticos, Produtos De Perfumaria E De Higiene Pessoal"
},
{
"codigo": "4782201",
"descricao": "Comércio Varejista De Calçados"
}
]
}Cobrança: 1 crédito.
Passo 4 — Consultar 2 ou mais empresas (lista de CNPJs)
Exemplo de requisição:
curl -X POST "https://api.cnpjdata.com.br/api/companies/list" \
-H "X-API-Key: <id>.<secret>" \
-H "Content-Type: application/json" \
-d '{
"cnpjs": ["01234567000189", "00987654000110"],
"page": 1,
"limit": 20
}'Resposta (todos os objetos de empresa vêm nesse formato dentro de data):
{
"searchId": "uuid-da-busca",
"data": [
{
"cnpjCompleto": "01.234.567/0001-89",
"razaoSocial": "EMPRESA EXEMPLO COMERCIO LTDA",
"nomeFantasia": "LOJA EXEMPLO",
"naturezaJuridicaCodigo": "2135",
"porteEmpresaCodigo": "01",
"situacaoCadastralCodigo": "02",
"cnaeFiscalPrincipalCodigo": "4781400",
"cnaeFiscalSecundariaCodigo": "4755502,4772500,4782201,4761003",
"codMunicipio": "4729",
"matrizFilialCodigo": "1",
"logradouro": "RUA EXEMPLO 1",
"numero": "100",
"complemento": "LOJA 01",
"bairro": "CENTRO",
"cep": "01000000",
"uf": "MG",
"telefone1": null,
"telefone2": null,
"email": null,
"dataInicioAtividade": "1997-01-21T00:00:00.000Z",
"dataSituacaoCadastral": "2005-11-03T00:00:00.000Z",
"anoInicio": 1997,
"naturezaJuridicaRef": {
"codigo": "2135",
"descricao": "Empresário (Individual)"
},
"porteEmpresaRef": {
"codigo": "01",
"descricao": "Micro Empresa"
},
"situacaoCadastralRef": {
"codigo": "02",
"descricao": "Ativa"
},
"cnaeRef": {
"codigo": "4781400",
"descricao": "Comércio Varejista De Artigos Do Vestuário E Acessórios"
},
"municipioRef": {
"codigo": "4729",
"descricao": "Jordania"
},
"matrizFilialRef": {
"codigo": "1",
"descricao": "Matriz"
},
"cnaesSecundarios": [
{
"codigo": "4755502",
"descricao": "Comercio Varejista De Artigos De Armarinho"
},
{
"codigo": "4761003",
"descricao": "Comércio Varejista De Artigos De Papelaria"
},
{
"codigo": "4772500",
"descricao": "Comércio Varejista De Cosméticos, Produtos De Perfumaria E De Higiene Pessoal"
},
{
"codigo": "4782201",
"descricao": "Comércio Varejista De Calçados"
}
]
}
],
"page": 1,
"limit": 20,
"total": 2,
"totalPages": 1
}Se enviar page, são debitados apenas os registros retornados nessa página. Se não enviar page, são debitados todos os registros encontrados e é gerado um arquivo completo.
Passo 5 — Buscar por filtros (export completo, sem page)
Exemplo de requisição com filtros:
curl -X GET "https://api.cnpjdata.com.br/api/companies?uf=SP&cidadeNome=Campinas&status=02" \
-H "X-API-Key: <id>.<secret>"Resposta (formato real retornado pela API, igual ao exemplo acima, dentro de data):
{
"searchId": "uuid-da-busca",
"data": [
{
"cnpjCompleto": "01.234.567/0001-89",
"razaoSocial": "EMPRESA EXEMPLO COMERCIO LTDA",
"nomeFantasia": "LOJA EXEMPLO",
"naturezaJuridicaCodigo": "2135",
"porteEmpresaCodigo": "01",
"situacaoCadastralCodigo": "02",
"cnaeFiscalPrincipalCodigo": "4781400",
"cnaeFiscalSecundariaCodigo": "4755502,4772500,4782201,4761003",
"codMunicipio": "4729",
"matrizFilialCodigo": "1",
"logradouro": "RUA EXEMPLO 1",
"numero": "100",
"complemento": "LOJA 01",
"bairro": "CENTRO",
"cep": "01000000",
"uf": "MG",
"telefone1": null,
"telefone2": null,
"email": null,
"dataInicioAtividade": "1997-01-21T00:00:00.000Z",
"dataSituacaoCadastral": "2005-11-03T00:00:00.000Z",
"anoInicio": 1997,
"naturezaJuridicaRef": {
"codigo": "2135",
"descricao": "Empresário (Individual)"
},
"porteEmpresaRef": {
"codigo": "01",
"descricao": "Micro Empresa"
},
"situacaoCadastralRef": {
"codigo": "02",
"descricao": "Ativa"
},
"cnaeRef": {
"codigo": "4781400",
"descricao": "Comércio Varejista De Artigos Do Vestuário E Acessórios"
},
"municipioRef": {
"codigo": "4729",
"descricao": "Jordania"
},
"matrizFilialRef": {
"codigo": "1",
"descricao": "Matriz"
},
"cnaesSecundarios": [
{
"codigo": "4755502",
"descricao": "Comercio Varejista De Artigos De Armarinho"
},
{
"codigo": "4761003",
"descricao": "Comércio Varejista De Artigos De Papelaria"
},
{
"codigo": "4772500",
"descricao": "Comércio Varejista De Cosméticos, Produtos De Perfumaria E De Higiene Pessoal"
},
{
"codigo": "4782201",
"descricao": "Comércio Varejista De Calçados"
}
]
}
],
"page": 1,
"limit": 20,
"total": 58,
"totalPages": 3
}Cobrança: debita o total de registros encontrados. Um arquivo completo é gerado e associado ao searchId.
Passo 6 — Buscar por filtros (paginação, com page)
Exemplo de requisição paginada:
curl -X GET "https://api.cnpjdata.com.br/api/companies?uf=SP&cidadeNome=Campinas&status=02&page=2&limit=20" \
-H "X-API-Key: <id>.<secret>"Resposta (exemplo):
{
"searchId": "uuid-da-busca-da-pagina",
"data": [
{
"cnpjCompleto": "12.345.678/0001-99",
"razaoSocial": "OUTRA EMPRESA LTDA",
"uf": "SP",
"situacaoCadastralCodigo": "02"
}
],
"page": 2,
"limit": 20,
"total": 58,
"totalPages": 3
}Cobrança: debita apenas a quantidade de registros retornados nessa página. Um arquivo é gerado no storage apenas com o conteúdo da página.
Passo 7 — Baixar o arquivo do resultado (via painel)
Acesse o painel autenticado, vá em Minhas consultas de API, localize a consulta pelo label e clique em Baixar.
O link é temporário (2 minutos) e cada resultado pode ser baixado até 2 vezes por dia.