Búsqueda de Empresas

En la API Comercial, en el Plan Premium, puedes hacer búsquedas utilizando filtros para encontrar empresas que cumplan con tus requisitos.

Atención: El acceso a este endpoint es exclusivo para suscriptores del Plan Premium.

Método: GET

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

Filtros

Puedes utilizar los filtros a continuación en tus consultas:

Campo	Descripción
atividade_principal_id	Código CNAE
atividade_secundaria_id	Código CNAE
atividade_id	Código CNAE (búsqueda en la actividad principal y secundaria)
natureza_juridica_id	Código de la Naturaleza Jurídica
razao_social	Razón Social
nome_fantasia	Nombre Fantasía
pais_id	Código del País del BACEN
estado_id	Código IBGE del estado
cidade_id	Código IBGE de la Ciudad
cep	CEP
situacao_cadastral	Situación cadastral en la Receita Federal
data_situacao_cadastral_de	Fecha de la Situación Cadastral (A partir de esta fecha) en el formato YYYY-MM-DD
data_situacao_cadastral_ate	Fecha de la Situación Cadastral (Hasta esta fecha) en el formato YYYY-MM-DD
porte_id	Id del tamaño de la empresa
socio_nome	Nombre del Socio
data_inicio_atividade_de	Fecha de Inicio de Actividad (A partir de esta fecha) en el formato YYYY-MM-DD
data_inicio_atividade_ate	Fecha de Inicio de Actividad (Hasta esta fecha) en el formato YYYY-MM-DD

Es crucial destacar que las consultas realizadas en este endpoint se basan en nuestra base de datos y no en la de la Receita Federal. Por lo tanto, pueden ocurrir discrepancias entre las informaciones, ya que nuestra base de datos puede tener un desfase de hasta 45 días en relación con los datos actualizados de la Receita Federal. Vale resaltar que, aunque realizamos registros diariamente debido a las consultas de CNPJ hechas en la API, el desfase aún puede ocurrir.

Lista de Situaciones Cadastrales:

• Activa

• Dada de baja

• Inapta

• Nula

• Suspendida

Lista de Tamaños Registrados:

ID	Descripción
01	No informado
02	Micro Empresa
03	Empresa de Pequeño Tamaño
05	Otros

Ejemplos de Solicitud

Retorna pesquisa sobre empresas

get

Autorizaciones

Parámetros de consulta

atividade_principal_idstringOpcional

Código CNAE da atividade principal

atividade_secundaria_idstringOpcional

Código CNAE da atividade secundária

atividade_idstringOpcional

Código CNAE (pesquisa na atividade principal e secundária)

natureza_juridica_idstringOpcional

Código da Natureza Jurídica

razao_socialstringOpcional

Razão Social

nome_fantasiastringOpcional

Nome Fantasia

pais_idstringOpcional

Código do País do BACEN

estado_idstringOpcional

Código IBGE do estado

cidade_idstringOpcional

Código IBGE da Cidade

cepstringOpcional

CEP

situacao_cadastralstringOpcional

Situação cadastral na Receita Federal

data_situacao_cadastral_destring · dateOpcional

Data da Situação Cadastral (A partir dessa data) no formato YYYY-MM-DD

data_situacao_cadastral_atestring · dateOpcional

Data da Situação Cadastral (Até essa data) no formato YYYY-MM-DD

porte_idstringOpcional

Id do porte da empresa

socio_nomestringOpcional

Nome do Sócio

data_inicio_atividade_destring · dateOpcional

Data de Inicio de Atividade (A partir dessa data) no formato YYYY-MM-DD

data_inicio_atividade_atestring · dateOpcional

Data de Inicio de Atividade (Até essa data) no formato YYYY-MM-DD

Respuestas

200

Sucesso

application/json

401

Não autenticado

application/json

get

HTTPcURLJavaScriptPython

GET /pesquisa HTTP/1.1
Host: comercial.cnpj.ws
Authorization: Bearer JWT
Accept: */*

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

Nosotros tenemos un paquete que puede ayudarte en la integración con 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);
}

Más información del paquete

Paginación

En caso de que la búsqueda retorne más de 20 CNPJs, la API dividirá la respuesta en páginas. Puedes verificar esto en el JSON de retorno de la API, en la propiedad "paginacion", que muestra la página actual, el total de páginas y el total de CNPJs:

{
  "paginacao": {
    "limite": 20,
    "pagina": 1,
    "paginas": 5,
    "total": 87
  }
}

Para buscar una página específica basta con informar el número de la página en la solicitud:

curl -X GET https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&pagina=2 -H "x_api_token: SEU_TOKEN"

También es posible alterar la cantidad de CNPJs retornados, el valor predeterminado es 20 pero puede ser hasta 100:

curl -X GET https://comercial.cnpj.ws/pesquisa?atividade_principal_id=6203100&pagina=2&limite=100 -H "x_api_token: SEU_TOKEN"

Ejemplo de Retorno

A continuación, un ejemplo del JSON retornado al buscar por el 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"
  ]
}