API de Leads B2B

API de Leads B2B para CRM, ERP, n8n e sistemas próprios

A API de Leads do Capturama permite que sistemas externos leiam leads/clientes de forma segura e automatizada. Ela é somente leitura, usa token de integração e foi pensada para fluxos com n8n, CRM, ERP, BI, planilhas e sistemas próprios.

Read-onlyToken BearerSincronização incremental
Produto

Para que serve a API de Leads do Capturama

A API transforma a base de leads/clientes do Capturama em uma fonte consultável por sistemas externos. Ela é útil quando RevOps, vendas, BI ou operação precisam manter outra ferramenta atualizada sem exportar planilha no fim do dia.

O contrato público é objetivo: ler leads, consultar um lead específico, verificar schema e checar a saúde da integração. A API não substitui o painel e não executa ações de escrita.

Integre leads sem exportar planilhas

Exportações manuais criam versões diferentes da verdade: uma planilha no comercial, outra no BI e outra enviada ao fornecedor. Com a API, o sistema de destino busca os registros no momento certo e mantém o histórico de sincronização sob controle.

O ganho aparece em rotinas simples, como atualizar um CRM, e em rotinas mais operacionais, como alimentar um ERP ou consolidar indicadores de prospecção em dashboards.

Como funciona a sincronização

O desenho recomendado evita duplicidade, reduz volume desnecessário e deixa a integração reprocessável.

01

Carga inicial

O sistema externo chama GET /public/v1/leads sem updated_since para montar a primeira base.

02

Atualização incremental

Nas próximas execuções, usa updated_since ou cursor para buscar registros novos ou atualizados.

03

Continuação por cursor

Quando has_more for true, usa page_info.next_cursor até terminar a página lógica.

O que você pode conectar

A API serve como fonte de leitura para automações e sistemas que já fazem parte da operação.

Automação

n8n

Monte fluxos com HTTP Request, token Bearer, updated_since e envio para CRM, ERP, planilhas ou BI.

Integrar com n8n

Vendas

CRM

Alimente o funil comercial com leads B2B sem depender de exportação manual ou planilha paralela.

Enviar leads para CRM

Operação

ERP

Leve dados de leads/clientes para processos operacionais com carga inicial, atualização incremental e controle de token.

Integrar com ERP

Dados

Planilhas e BI

Atualize Google Sheets, planilhas, Power BI e dashboards com dados vindos da API ou de um fluxo no n8n.

Ver planilhas e BI

Docs

Documentação técnica

Consulte autenticação, endpoints, paginação por cursor, sincronização incremental, schema e erros públicos.

Ver documentação da API

Segurança e token de integração

As chamadas usam Authorization: Bearer SEU_TOKEN_AQUI. O token completo aparece apenas no momento da criação dentro do painel do SaaS; depois disso, o painel exibe apenas prefixo ou preview.

Sistemas externos devem guardar o token com segurança, limitar acesso operacional e revogar o token se houver troca de fornecedor, suspeita de exposição ou encerramento da integração.

Endpoints principais

GET /public/v1/leads

Lista leads com limit, cursor, updated_since e include_deleted.

GET /public/v1/leads/{lead_id}

Consulta um lead específico dentro do escopo do token.

GET /public/v1/leads/schema

Retorna o contrato público de campos disponíveis.

GET /public/v1/integration/health

Verifica se a integração está habilitada.

Exemplo de resposta

A listagem retorna data e page_info para controle de paginação.

{
  "data": [
    {
      "id": "123",
      "first_name": "Maria",
      "last_name": "Silva",
      "full_name": "Maria Silva",
      "email": "maria@example.com",
      "phone": "5545999999999",
      "origin": "MANUAL",
      "status": true,
      "subscribed": true,
      "created_at": "2026-05-06T12:00:00Z",
      "updated_at": "2026-05-06T12:30:00Z",
      "deleted": false,
      "deleted_at": null,
      "last_bought": null,
      "total_orders": 0,
      "lead_linkedin_url": null,
      "lead_role": null,
      "lead_type": null,
      "lead_area": null
    }
  ],
  "page_info": {
    "next_cursor": null,
    "has_more": false
  }
}

Documentação técnica

Use as referências abaixo para entregar ao desenvolvedor, ao fornecedor do CRM ou ao parceiro de ERP.

Próximo passo

Comece pela documentação e depois escolha o destino

Se o objetivo for CRM, ERP, BI ou planilha, a base técnica é a mesma: token seguro, leitura read-only e sincronização incremental.

FAQ

Perguntas frequentes

A API de Leads cria ou altera dados? +

Não. O contrato público documentado aqui é somente leitura. Ele permite consultar leads/clientes, mas não cria, edita nem remove dados.

Como uma integração deve começar? +

A primeira sincronização pode buscar todos os leads. Depois, o sistema externo deve usar updated_since ou cursor para buscar apenas o que mudou.

Posso usar a API com CRM, ERP, BI e planilhas? +

Sim, desde que o destino aceite integração via API, n8n ou implementação técnica. Não há promessa de integração nativa certificada com ferramentas específicas.