Privacidade e Cookies

Utilizamos cookies para melhorar sua experiência e analisar o tráfego do site. Ao continuar navegando, você concorda com nossa Política de Privacidade.

EcoBigData

API de Dados

API REST de consulta CNPJ para o seu produto

Mais de 320 campos por empresa, autenticação por token, exemplos em cURL/Node e sandbox com 5 consultas/mês no plano Starter.

Obter API key grátisVer documentação

Por que integrar

A mesma base da plataforma EcoBigData, via HTTP.

Use nos formulários, CRMs, ERPs, automações e pipelines de crédito ou antifraude — sem reinventar coleta de dados públicos.

320+ campos

Cadastro, QSA, CNAE, contatos e sinais relacionais em JSON estável.

Pronto para produção

Infra AWS, rate limit por plano e consumo auditável por crédito.

Auth simples

Bearer token (JWT). Gere a chave após criar a conta e comece a chamar.

Casos reais

Onboarding, enriquecimento em lote, prospecção e validação de CNPJ.

Cobertura de dados

O que cada consulta pode retornar

Respostas JSON com atributos consolidados de fontes oficiais. A disponibilidade de alguns blocos varia conforme o CNPJ e o plano.

Cadastral

  • Razão social e nome fantasia
  • Situação cadastral
  • Data de abertura
  • Porte e capital social

Atividade

  • CNAE principal
  • CNAEs secundários
  • Natureza jurídica
  • Simples Nacional / MEI

Contato e localização

  • Endereço completo
  • Telefones
  • E-mail
  • UF e município

Relacional

  • QSA (sócios)
  • Matriz e filiais
  • Vínculos para Grafo PJ
  • Sinais para compliance

Documentação

Autenticação, endpoints e exemplos

Base URL: https://ecobigdata.com.br/api. Após o cadastro, gere o token na área logada (integrações / API) e envie no headerAuthorization: Bearer ….

Como autenticar

  1. Crie a conta em Solicitar acesso (plano Starter inclui sandbox).
  2. Na área logada, gere um token de API / integração.
  3. Inclua o token em todas as chamadas protegidas.
  4. Cada consulta consome créditos do saldo da conta — monitore em Financeiro.

Endpoints principais

GET/api/company/details?cnpj={cnpj}

Dossiê completo do CNPJ: cadastral, CNAE, endereço, contatos, porte e capital.

GET/api/company/socios?cnpj={cnpj}

Quadro societário (QSA) com participação e vínculos de sócios PF/PJ.

GET/api/company/funcionarios?cnpj={cnpj}

Indicadores de empregados quando disponíveis na base consolidada.

POST/api/company/prospection

Prospecção por filtros (CNAE, UF, porte, situação) com retorno paginado.

POST/api/company/filter-distribution

Distribuição agregada para dashboards (UF, CNAE, porte).

cURL
curl -sS "https://ecobigdata.com.br/api/company/details?cnpj=00000000000191" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Accept: application/json"
Node.js (fetch)
const res = await fetch(
  "https://ecobigdata.com.br/api/company/details?cnpj=00000000000191",
  { headers: { Authorization: "Bearer SEU_TOKEN" } }
);
const empresa = await res.json();

Limites e boas práticas

  • • Rate limit e volume de créditos variam por plano (Starter, Pro, Enterprise).
  • • Prefira cache local para o mesmo CNPJ quando a regra de negócio permitir.
  • • Trate HTTP 401/403 (token) e 429 (limite) com retry/backoff.
  • • Para exploração interativa completa após login, use o API Marketplace em /app/api-marketplace.

Comece com o sandbox grátis

5 consultas/mês no Starter para validar a integração. Sem cartão para experimentar os endpoints principais.

Obter API key grátisAgendar demonstração