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

GEThttps://comercial.cnpj.ws/pesquisa

Authorization

auth

Query 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: {
      "Authorization": "Bearer JWT"
    },
});
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"
  ]
}

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