Pesquisa de Empresas
Na API Comercial você consegue fazer pesquisas utilizando filtros para encontrar empresas que atendam aos seus requisitos.
Método: GET
Endpoint: https://comercial.cnpj.ws/pesquisa?ADICIONE_OS_FILTROS
#
FiltrosVocê pode utilizar os filtros abaixo em suas consultas.
Campo | Descrição |
---|---|
atividade_principal_id | Código CNAE |
atividade_secundaria_id | Código CNAE |
atividade_id | Código CNAE (pesquisa na atividade principal e secundária) |
natureza_juridica_id | Código da Natureza Jurídica |
razao_social | Razão Social |
nome_fantasia | Nome Fantasia |
pais_id | Código do País do BACEN |
estado_id | Código IBGE do estado |
cidade_id | Código IBGE da Cidade |
cep | CEP |
situacao_cadastral | Situação cadastral na Receita Federal |
data_situacao_cadastral_de | Data da Situação Cadastral (A partir dessa data) no formato YYYY-MM-DD |
data_situacao_cadastral_ate | Data da Situação Cadastral (Até essa data) no formato YYYY-MM-DD |
porte_id | Id do porte da empresa |
socio_nome | Nome do Sócio |
Lista de Situações Cadastrais:
- Ativa
- Baixada
- Inapta
- Nula
- Suspensa
Lista de portes cadastrados:
ID | Descrição |
---|---|
01 | Não informado |
02 | Micro Empresa |
03 | Empresa de Pequeno Porte |
05 | Demais |
#
Exemplos de requisição- JavaScript
- PHP
- Python
yarn add consultar-cnpj
const consultarCNPJ = require("consultar-cnpj");
async function getCNPJ() { const token = "INFORME O SEU TOKEN DE ACESSO"; const page = 2;
const data = await consultarCNPJ.pesquisa( { atividade_principal_id: "6203100", estado_id: 28 }, token, page ); console.log(data);}
<?php
$url = "https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&estado_id=28";
$curl = curl_init($url);curl_setopt($curl, CURLOPT_URL, $url);curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$headers = array( "x_api_token: SEU_TOKEN",);curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);//for debug only!curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($curl);curl_close($curl);var_dump($resp);
import requestsfrom requests.structures import CaseInsensitiveDict
url = "https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&estado_id=28"
headers = CaseInsensitiveDict()headers["x_api_token"] = "SEU_TOKEN"
resp = requests.get(url, headers=headers)
print(resp.status_code)
#
PaginaçãoCaso a pesquisa retorna mais de 20 CNPJ's a API irá dividir a resposta em páginas. Você pode verificar isso no JSON de retono da API, na propriedade "paginacao", que exibe a página atual, o total de páginas e o total de CNPJ's:
{ "paginacao": { "limite": 20, "pagina": 1, "paginas": 5, "total": 87 }}
Para buscar uma página específica basta informar o número da página na requisição:
curl -X GET https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&page=2 -H "x_api_token: SEU_TOKEN"
#
Exemplo de RetornoAbaixo um exemplo do JSON retornado ao se pesquisar pelo CNAE 6203100:
{ "paginacao": { "limite": 20, "pagina": 1, "paginas": 1494, "total": 29865 }, "ordenacao": [], "filtros_disponiveis": [ "cnpj", "cnpj_raiz", "natureza_juridica_id", "porte_id", "razao_social", "nome_fantasia", "pais_id", "estado_id", "cidade_id", "cep", "atividade_principal_id" ], "filtros_aplicados": { "atividade_principal_id": "6203100" }, "data": [ "19323263000160", "03124023000104", "64919913000199", "36427967000100", "06370042000109", "01056469000105", "03292219000108", "94338217000664", "01645901000101", "02868026000181", "04957691000177", "01755516000109", "04970015000133", "65144347000153", "04810384000169", "74641804000106", "82296112000104", "03035876000161", "33643305009801", "05121798000143" ]}