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}'

Autenticação

API Key

Gere sua chave em Configurações → Desenvolvedores no painel do projeto e marque as permissões de que precisa (veja o que cada uma libera). Para os endpoints de leads, marque leads:read.

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.

O que a API key libera

Cada chave é de um projeto e só enxerga os dados dele. Mande-a em Authorization: Bearer dskey_… e marque só as permissões de que precisa. Criar e alterar datasets e colunas pede qualquer uma das permissões de datasets.

PermissãoLiberaGuia
leads:readConsultar, detalhar e exportar os leads do projeto.Leads API
datasets:readConsultar as linhas dos datasets.Datasets
datasets:writeGravar, atualizar e apagar linhas em lote e enviar CSV.Datasets
datasets:adminProcessar a importação de um CSV enviado. Não inclui write nem read: marque junto as que for usar.Datasets
hosted_connections:writeGerar links para seus usuários conectarem o Instagram (white label), listar e revogar essas conexões.Conexão hospedada

Para agir em nome de uma pessoa (pedir conexões de fontes, ler o Instagram, mandar WhatsApp, painéis e mais), use um app parceiro com OAuth: a referência da /v1 lista cada rota e o escopo que ela pede.

Conexão hospedada (white label)

Seus usuários conectam o Instagram dentro do seu sistema, com a sua marca, por um link assinado. Sem conta no CrazyLeads.

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