API REST para integrar dados de empresas brasileiras nos seus sistemas.
Todas as requisicoes devem incluir o header X-API-Key com sua chave de API.
curl -H "X-API-Key: nuvnia_sua_chave_aqui" https://api.leads.nuvnia.com/api/v2/usageGere sua API key no dashboard. Disponivel para planos Pro e Business.
Buscar empresas com filtros.
| Parametro | Tipo | Descricao |
|---|---|---|
| uf | string | Sigla do estado (ex: SP, RJ) |
| cnae | string | Codigo CNAE principal (7 digitos) |
| porte | string | 01 (ME), 03 (EPP), 05 (Demais) |
| cidade | string | Codigo do municipio |
| nome | string | Razao social (busca parcial) |
| limit | integer | Resultados por pagina (1-100, default 50) |
| offset | integer | Paginacao |
curl -H "X-API-Key: nuvnia_..." "https://api.leads.nuvnia.com/api/v2/leads/search?uf=SP&cnae=4711302&limit=10"{
"data": [
{
"cnpj": "12345678000199",
"razao_social": "EMPRESA EXEMPLO LTDA",
"email": "contato@empresa.com",
"telefone1": "(11) 99999-1234",
"uf": "SP",
"cidade": "Sao Paulo",
"cnae_principal": "4711302",
"capital_social": "100000.00"
}
],
"meta": { "total": 10, "limit": 10, "offset": 0 }
}Consultar dados de um CNPJ especifico (14 digitos, sem formatacao).
curl -H "X-API-Key: nuvnia_..." "https://api.leads.nuvnia.com/api/v2/leads/12345678000199"Verificar consumo de creditos do mes atual.
curl -H "X-API-Key: nuvnia_..." "https://api.leads.nuvnia.com/api/v2/usage"{
"data": { "plan": "pro", "used": 42, "limit": 1000, "remaining": 958 }
}100 requisicoes por minuto por API key. Ao exceder, voce recebera status 429 com header Retry-After.
| Status | Descricao |
|---|---|
| 400 | Parametros invalidos |
| 401 | API key nao fornecida ou invalida |
| 403 | Plano nao suportado (requer Pro+) |
| 404 | CNPJ nao encontrado |
| 429 | Rate limit excedido |
| 500 | Erro interno do servidor |
Cada requisicao a /leads/search e /leads/:cnpj consome 1 credito. O endpoint /usage nao consome creditos. Os creditos sao compartilhados com o uso via dashboard.