API Reference
A API REST do CrazyLeads permite consultar, detalhar e exportar seus leads de forma programática. Integre com seu CRM, automações ou dashboards externos.
Início Rápido
Faça sua primeira requisição em 30 segundos:
curl -X POST https://apiserver.crazyleads.com.br/api/leads/query/ \
-H "Authorization: Bearer dskey_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{"project_id": "SEU_PROJECT_ID", "limit": 10}'Recursos
Integrações
Guias passo a passo para conectar assistentes de IA aos seus dados.
Leads API
Listar, detalhar e exportar leads. Filtros avançados com lógica AND/OR. Timeline de eventos.
MCP Server
Conecte seus leads a Claude, Cursor e outros assistentes de IA via Model Context Protocol.
Autenticação
API Key
Gere sua chave em Configurações → API Keys no painel do projeto. Marque a permissão leads:read para acessar os endpoints de leads.
Segurança
Cada API Key está vinculada a um projeto e só acessa dados dele. Nunca exponha a chave em código client-side ou repositórios públicos.
Rate Limits
Os endpoints de datasets aplicam 3.000 leituras/minuto (burst 300), 600 escritas/minuto (burst 100) e 10 importações/hora (burst 2), por chave. Trate 429 com espera e nova tentativa em toda integração: os limites podem mudar sem aviso e passam a valer para mais endpoints.
Convenções
Datas e fusos
Todo horário sai em ISO 8601 com o deslocamento explícito, em UTC — por exemplo 2025-06-15T10:30:00+00:00. Use um parser de ISO 8601 que leia o deslocamento; não presuma o sufixo Z nem converta para o fuso de Brasília por conta própria.
Erros
Decida pelo código HTTP, não pelo texto da mensagem: o corpo do erro varia entre as partes mais antigas da API. Os endpoints publicados a partir de agora usam sempre o mesmo envelope, com um request_id para você citar no suporte.
Paginação
Os endpoints de leads e datasets paginam por deslocamento, com page_info na resposta. Os novos paginam por cursor: leia next_cursor e repita até vir nulo, sem interpretar o conteúdo do cursor.
Versão e compatibilidade
Os endpoints atuais não têm versão no caminho e continuam valendo como estão — nada do que você já integrou muda de formato. O que for publicado a partir de agora vive sob um caminho versionado.
Repetir uma escrita
Ainda não há chave de idempotência. Se uma escrita falhar sem resposta, consulte o estado antes de reenviar — reenviar às cegas pode duplicar o registro.
Base URL
https://apiserver.crazyleads.com.br