Documentação da API

Referência da API REST do EmpresaIQ para desenvolvedores, CRM e automações.

Autenticação

Todas as requisições devem incluir sua chave de API no header Authorization.

Header obrigatório

Authorization: Bearer eiq_SUA_CHAVE_AQUI

Base URL: https://api.empresaiq.com.br/v1

Endpoint

Recurso disponível na API v1

GET/empresa/perfil/{cnpj}

Perfil empresarial completo: cadastro oficial, presença digital, logos, inteligência de negócios e descrição gerada por IA em português do Brasil, com score de confiança.

Parâmetro de caminho cnpj: 14 dígitos, com ou sem formatação. Query opcional forceRefresh=true força nova coleta de dados.

1 crédito

Reconsultas do mesmo CNPJ em até 30 dias não consomem crédito adicional. Respostas bem-sucedidas incluem o header X-Credits-Used indicando quantos créditos foram debitados.

Campos da Resposta

Objeto data retornado em respostas com success: true. Valores de texto humanos estão em português do Brasil quando aplicável.

Campo	Tipo	Descrição
`cnpj`	string	CNPJ formatado (XX.XXX.XXX/XXXX-XX).
`name`	string	Razão social conforme cadastro oficial.
`tradeName`	string	Nome fantasia. String vazia quando não informado.
`status`	string	Situação cadastral em português (ex.: Ativa, Baixada, Inapta).
`openingDate`	string	Data de abertura no formato dd/mm/aaaa.
`website, linkedin, instagram, facebook`	{ value, confidence }	Presença digital validada. value é URL ou null; confidence é 0-100.
`logos`	array	Lista de logos descobertos. Cada item inclui url, confidence, source e sizes (opcional).
`description, businessSummary`	{ value, confidence }	Textos gerados por IA em português do Brasil. value é string ou null.
`industry`	{ value, subcategory, confidence }	Setor e subcategoria em português do Brasil. Campos podem ser null.
`companySize`	{ value, confidence }	Faixa estimada de funcionários. Valores: 1-10, 11-50, 51-200, 201-1000, 1001-5000, 5001-10000, 10000+.
`companyType`	{ value, confidence }	Tipo de negócio. Valores: Startup, PME, Médio porte, Grande empresa, Setor público, Sem fins lucrativos.
`keywords`	string[]	Até 10 palavras-chave em português do Brasil, em minúsculas.
`generatedAt`	string	Data e hora de geração do perfil em ISO 8601.

Exemplo de Resposta

GET /empresa/perfil/{cnpj}

1{
2  "success": true,
3  "cached": false,
4  "data": {
5    "cnpj": "33.000.167/0001-01",
6    "name": "Petróleo Brasileiro S.A. - Petrobras",
7    "tradeName": "Petrobras",
8    "status": "Ativa",
9    "openingDate": "20/09/1953",
10    "website": {
11      "value": "https://petrobras.com.br",
12      "confidence": 98
13    },
14    "linkedin": {
15      "value": "https://linkedin.com/company/petrobras",
16      "confidence": 96
17    },
18    "instagram": {
19      "value": null,
20      "confidence": 0
21    },
22    "facebook": {
23      "value": null,
24      "confidence": 0
25    },
26    "logos": [
27      {
28        "url": "https://petrobras.com.br/apple-touch-icon.png",
29        "confidence": 94,
30        "source": "apple-touch-icon",
31        "sizes": "180x180"
32      },
33      {
34        "url": "https://petrobras.com.br/favicon.ico",
35        "confidence": 92,
36        "source": "favicon.ico"
37      }
38    ],
39    "description": {
40      "value": "Empresa brasileira de energia, líder no setor de óleo e gás, com atuação integrada em exploração, produção, refino e comercialização.",
41      "confidence": 93
42    },
43    "businessSummary": {
44      "value": "Empresa integrada de energia focada em exploração de petróleo, refino, logística e produção de energia.",
45      "confidence": 94
46    },
47    "industry": {
48      "value": "Petróleo e gás",
49      "subcategory": "Exploração de petróleo",
50      "confidence": 95
51    },
52    "companySize": {
53      "value": "10000+",
54      "confidence": 85
55    },
56    "companyType": {
57      "value": "Grande empresa",
58      "confidence": 94
59    },
60    "keywords": [
61      "energia",
62      "petróleo",
63      "refino",
64      "óleo",
65      "logística"
66    ],
67    "generatedAt": "2026-06-10T12:00:00.000Z"
68  }
69}

Exemplos de Código

Integre a API em sua stack favorita

1const response = await fetch(
2  "https://api.empresaiq.com.br/v1/empresa/perfil/33000167000101",
3  {
4    headers: {
5      Authorization: "Bearer eiq_SUA_CHAVE_AQUI",
6    },
7  }
8);
9
10const data = await response.json();
11console.log(data.data.status);              // Ativa
12console.log(data.data.companyType.value);   // Grande empresa
13console.log(data.data.industry.value);      // Petróleo e gás
14console.log(data.data.logos[0]?.url);

Teste com um CNPJ em menos de 2 minutos

Crie sua conta e comece a enriquecer dados empresariais brasileiros pelo dashboard ou pela API.

Créditos grátis para testar
Dashboard e API disponíveis na hora
Feito para empresas brasileiras

Ver documentação

Passo 1

Crie sua conta

Entre com Google em segundos. Sem cartão de crédito.

Passo 2

Consulte empresas

Busque CNPJs no dashboard e veja perfis completos enriquecidos por IA.

Passo 3

Integre via API

Gere sua chave de API e conecte ao CRM, vendas ou automações.