API REST · v1.0.0

Documentação da API LeadCNPJ

Integre o LeadCNPJ ao seu CRM, ERP ou ferramenta de automação. Consulte CNPJs, busque empresas por filtros firmográficos e enriqueça listas em lote — tudo via REST.

Visão Geral

Autenticação

Toda requisição precisa do header Authorization com sua chave de API:

Authorization: Bearer leadcnpj_live_<32-char-secret>

Formato da chave

As chaves seguem o padrão:

  • leadcnpj_live_<32-char-secret> — produção (consome créditos reais)
  • leadcnpj_test_<32-char-secret> — teste (mesmo banco, mesmo débito; flag útil pra distinguir integrações)

Como criar uma chave

Acesse Configurações → API e clique em "Nova chave". Apenas owner/admin de grupo em plano com API (Growth, Scale, Scale AI ou Enterprise) conseguem criar. A chave em claro é mostrada uma única vez — anote em local seguro.

Recomendação: crie chaves separadas pra cada integração (HubSpot, Zapier, sistema interno) com nome descritivo. Facilita revogar uma sem quebrar as outras.

Erros de autenticação

  • 401 invalid_api_key: chave ausente, formato inválido ou não cadastrada.
  • 401 revoked_api_key: chave foi revogada via painel.
  • 403 plan_does_not_allow_api: plano do dono da chave não inclui API (faça upgrade a partir do Growth).