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:
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:
01
Não informado
02
Micro Empresa
03
Empresa de Pequeno Porte
05
Demais
Exemplos de Requisição
Nós possuímos um pacote que pode te ajudar na integração com JavaScript:
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:
Para buscar uma página específica basta informar o número da página na requisição:
Também é possivel alterar a quantidade de CNPJ's retornados, o padrão é 20 mas pode ser até 100:
Exemplo de Retorno
Abaixo um exemplo do JSON retornado ao se pesquisar pelo CNAE 6203100:
Atualizado