Pesquisa de Empresas

Na API Comercial, no Plano Premium, você consegue fazer pesquisas utilizando filtros para encontrar empresas que atendam aos seus requisitos.

Atenção: O acesso a esse endpoint é exclusivo para assinantes do Plano Premium.

Método: GET

Endpoint: https://comercial.cnpj.ws/pesquisa?ADICIONE_OS_FILTROS

Filtros

Você 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
data_inicio_atividade_de	Data de Inicio de Atividade (A partir dessa data) no formato YYYY-MM-DD
data_inicio_atividade_ate	Data de Inicio de Atividade (Até essa data) no formato YYYY-MM-DD

É crucial destacar que as consultas realizadas neste endpoint baseiam-se em nosso banco de dados e não no da Receita Federal. Portanto, podem ocorrer discrepâncias entre as informações, já que nosso banco de dados pode ter uma defasagem de até 45 dias em relação aos dados atualizados da Receita Federal. Vale ressaltar que, embora realizemos cadastros diariamente devido às consultas de CNPJ feitas na API, a defasagem ainda pode ocorrer.

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

Retorna pesquisa sobre empresas

GEThttps://comercial.cnpj.ws/pesquisa

Authorization

x_api_tokentoken

Query parameters

Header parameters

Response

200401

Sucesso

Body

application/json

paginacaoobject

ordenacaoarray of string

filtros_disponiveisarray of string

filtros_aplicadosobject

dataarray of string

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://comercial.cnpj.ws/pesquisa', {
    method: 'GET',
    headers: {
      "x_api_token": "x_api_token <apiKey>"
    },
});
const data = await response.json();

Response

200401

{
  "paginacao": {
    "limite": 1,
    "pagina": 1,
    "paginas": 1,
    "total": 1
  },
  "ordenacao": [
    "text"
  ],
  "filtros_disponiveis": [
    "text"
  ],
  "filtros_aplicados": {
    "atividade_principal_id": "text"
  },
  "data": [
    "text"
  ]
}

Nós possuímos um pacote que pode te ajudar na integração com JavaScript:

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&pagina=2 -H "x_api_token: SEU_TOKEN"

Também é possivel alterar a quantidade de CNPJ's retornados, o padrão é 20 mas pode ser até 100:

curl -X GET https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&pagina=2&limite=100 -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"
  ]
}