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 (endereço, CNAEs, quadro societário), presença digital, logos, inteligência de negócios e descrição gerada por IA, com score de confiança por campo enriquecido.

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. Perfis em cache podem omitir campos adicionados em versões recentes até uma nova coleta com forceRefresh=true. 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
Dados cadastrais
`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.
`legalNature`	string	Natureza jurídica conforme cadastro oficial.
`city`	string	Município do endereço cadastral.
`state`	string	UF do endereço cadastral (2 letras).
`address`	object	Endereço cadastral. Subcampos: street, number, complement, neighborhood, postalCode, phone.
`primaryCnae`	{ code, description }	CNAE principal conforme cadastro oficial.
`secondaryCnaes`	array	CNAEs secundários. Cada item inclui code e description.
`partners`	array	Quadro societário (QSA) com name e qualification quando disponível.
`officialPorte`	string	Classificação de porte da Receita Federal: 00 Não informado, 01 Micro empresa, 03 Empresa de Pequeno Porte, 05 Demais (empresa que não se enquadra como microempresa ou EPP).
`officialPorteCode`	number	Código numérico do porte no layout de dados abertos do CNPJ (0, 1, 3 ou 5).
`estimatedRevenue`	string	Faixa de faturamento derivada dos limites legais de MEI, microempresa e EPP. Não se aplica ao porte Demais (05).
`socialCapital`	string	Capital social formatado em reais (BRL).
`officialCompanyType`	string	Classificação derivada da natureza jurídica quando aplicável (ex.: Setor público, Sem fins lucrativos).
`opcaoPeloSimples`	boolean	Indica se a empresa optou pelo Simples Nacional.
`opcaoPeloMei`	boolean	Indica se a empresa é optante pelo MEI.
Enriquecimento com IA
`website`	{ value, confidence }	Site oficial validado. value é URL ou null; confidence é 0-100.
`linkedin`	{ value, confidence }	Perfil LinkedIn validado. value é URL ou null; confidence é 0-100.
`instagram`	{ value, confidence }	Perfil Instagram validado. value é URL ou null; confidence é 0-100.
`facebook`	{ value, confidence }	Perfil Facebook validado. value é URL ou null; confidence é 0-100.
`logos`	array	Lista de logos descobertos. Cada item inclui url, confidence, source e sizes (opcional).
`description`	{ value, confidence }	Descrição gerada 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 com IA. Valores: 1-10, 11-50, 51-200, 201-1000, 1001-5000, 5001-10000, 10000+.
`companyType`	{ value, confidence }	Tipo de negócio estimado com IA. 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    "legalNature": "Sociedade de Economia Mista",
11    "city": "Rio de Janeiro",
12    "state": "RJ",
13    "address": {
14      "street": "Avenida República do Chile",
15      "number": "65",
16      "complement": "Edifício sede",
17      "neighborhood": "Centro",
18      "postalCode": "20031-912",
19      "phone": "21 3224-1510"
20    },
21    "primaryCnae": {
22      "code": "0600001",
23      "description": "Extração de petróleo e gás natural"
24    },
25    "secondaryCnaes": [
26      {
27        "code": "1921700",
28        "description": "Fabricação de produtos do refino de petróleo"
29      },
30      {
31        "code": "3520401",
32        "description": "Produção de gás"
33      }
34    ],
35    "partners": [
36      {
37        "name": "União Federal",
38        "qualification": "Acionista controlador"
39      }
40    ],
41    "officialPorte": "Demais",
42    "officialPorteCode": 5,
43    "socialCapital": "R$ 205.432.000.000,00",
44    "opcaoPeloSimples": false,
45    "opcaoPeloMei": false,
46    "website": {
47      "value": "https://petrobras.com.br",
48      "confidence": 98
49    },
50    "linkedin": {
51      "value": "https://linkedin.com/company/petrobras",
52      "confidence": 96
53    },
54    "instagram": {
55      "value": null,
56      "confidence": 0
57    },
58    "facebook": {
59      "value": null,
60      "confidence": 0
61    },
62    "logos": [
63      {
64        "url": "https://petrobras.com.br/apple-touch-icon.png",
65        "confidence": 94,
66        "source": "apple-touch-icon",
67        "sizes": "180x180"
68      },
69      {
70        "url": "https://petrobras.com.br/favicon.ico",
71        "confidence": 92,
72        "source": "favicon.ico"
73      }
74    ],
75    "description": {
76      "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.",
77      "confidence": 93
78    },
79    "industry": {
80      "value": "Petróleo e gás",
81      "subcategory": "Exploração de petróleo",
82      "confidence": 95
83    },
84    "companySize": {
85      "value": "10000+",
86      "confidence": 85
87    },
88    "companyType": {
89      "value": "Grande empresa",
90      "confidence": 94
91    },
92    "keywords": [
93      "energia",
94      "petróleo",
95      "refino",
96      "óleo",
97      "logística"
98    ],
99    "generatedAt": "2026-06-10T12:00:00.000Z"
100  }
101}

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.