Sobre a API da Econodata

A API da Econodata foi desenvolvida para escalar operações de dados B2B com governança, permitindo a integração direta da inteligência de mercado da plataforma aos sistemas dos clientes e a automação de processos críticos de prospecção, enriquecimento e gestão de leads.

Sua documentação está disponível via Swagger, podendo ser acessada por meio deste link, onde é possível explorar todos os endpoints, parâmetros e regras de consumo.

Este material foi criado com o objetivo de traduzir a documentação técnica para um uso prático e orientado a negócio, apoiando clientes e times técnicos na correta utilização da API, maximizando valor, reduzindo riscos operacionais e garantindo o uso eficiente dos dados da plataforma.

O que é possível fazer com a API

Em termos práticos, a API habilita quatro grandes frentes de valor:

• Consulta de empresas
• • Por lista de CNPJs
  • Por parâmetros estruturados (CNPJ, raiz, e-mail, site)
• Gestão de Leads
• • Aplicação de tags para qualificação e segmentação
• Governança e segurança
• • Autenticação via Token de Integração
  • Validação e controle de consumo por créditos

Essa arquitetura permite desde integrações simples (CRM, planilhas, automações no-code) até pipelines avançados de dados e IA.

Autenticação: como gerar e usar o Token de Integração

Como gerar o token

• Acesse o menu Integrações dentro da plataforma de prospecção da Econodata
• Cadastre um novo token informando:
• • Nome da integração (exibido como origem das empresas enviadas)
  • URL de Webhook (opcional)
• Salve e armazene o token com segurança

Como usar o token nas requisições

O token deve ser enviado no header da requisição:

• x-api-token

→ Utilizado na maioria dos endpoints

• x-ecdt-token

→ Necessário em requisições específicas

→ Token gerado dinamicamente e visível nas DevTools do navegador

⚠️ Atenção operacional: Requisições de teste realizadas via botão “Try it out” no Swagger consomem créditos reais.

Modelo de Créditos: o que você precisa saber

A Econodata opera com um modelo de consumo por crédito, alinhado à plataforma:

• Cada empresa exportada via API consome 1 crédito
• Empresas já extraídas anteriormente não consomem crédito novamente
• O consumo via API segue exatamente as mesmas regras da plataforma web

✅ Recomendação de CS: valide previamente o volume esperado de chamadas para evitar consumo não planejado.

Limitações Técnicas (RateLimit)

Para garantir estabilidade e performance:

• Até 75 requisições por minuto
• Máximo de 100 CNPJs por requisição
• Exceder esses limites resulta em erro automático

Esse modelo favorece integrações robustas e previsíveis, evitando abusos ou gargalos sistêmicos.

Endpoints Disponíveis

Consulta de Empresas

POST /v2/companies

Consulta múltiplas empresas via lista de CNPJs.

POST /v2/companies/search

Consulta uma única empresa por:

• CNPJ
• Raiz do CNPJ
• E-mail
• Site

Gestão de Webhooks

GET /v2/webhooks

Lista todos os webhooks ativos do cliente.

GET /v2/webhook

Consulta um webhook específico.

POST /v2/webhooks

Cria um novo webhook.

PUT /v2/webhooks

Edita configurações de uma integração existente.

GET /v2/info-token

Retorna informações sobre os webhooks ativos associados ao token.

Gestão de Leads

POST /v2/update-lead

Adiciona tags às empresas enviadas ideal para:

• Classificação de leads
• Orquestração de funis
• Integrações com CRM e automações

Validação de Token

GET /valid-token-integration/{apiToken}

Verifica se o token de integração está ativo e válido.

Boas Práticas Recomendadas

✅ Use lotes de até 100 CNPJs para maximizar eficiência

✅ Centralize o consumo via API em jobs controlados

✅ Monitore créditos e limites antes de escalar integrações

✅ Utilize tags como pilar de inteligência operacional

❌ Evite testes em produção sem controle de consumo

Actualizado em: 23/01/2026