Pular para o conteúdo principal

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

Filtros#

Você pode utilizar os filtros abaixo em suas consultas.

CampoDescrição
atividade_principal_idCódigo CNAE
atividade_secundaria_idCódigo CNAE
atividade_idCódigo CNAE (pesquisa na atividade principal e secundária)
natureza_juridica_idCódigo da Natureza Jurídica
razao_socialRazão Social
nome_fantasiaNome Fantasia
pais_idCódigo do País do BACEN
estado_idCódigo IBGE do estado
cidade_idCódigo IBGE da Cidade
cepCEP
situacao_cadastralSituação cadastral na Receita Federal
data_situacao_cadastral_deData da Situação Cadastral (A partir dessa data) no formato YYYY-MM-DD
data_situacao_cadastral_ateData da Situação Cadastral (Até essa data) no formato YYYY-MM-DD
porte_idId do porte da empresa
socio_nomeNome do Sócio

Lista de Situações Cadastrais:

  • Ativa
  • Baixada
  • Inapta
  • Nula
  • Suspensa

Lista de portes cadastrados:

IDDescrição
01Não informado
02Micro Empresa
03Empresa de Pequeno Porte
05Demais

Exemplos de requisição#

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);}

Mais informações do pacote

Paginação#

Caso 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 Retorno#

Abaixo 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"  ]}