Documentação ZapGet API

Consulte rapidamente se um número é WhatsApp, obtenha foto de perfil, nome e status em milissegundos.

Esta página é pública. Para gerenciar chaves e créditos, acesse o painel autenticado.

`GET`Endpoint de Consulta

Integre em qualquer ambiente: Node, Python, PHP ou plataformas No-Code (Make, n8n, Typebot).

Estrutura da Requisição

URL: https://zapgetapi.online/api/v1/whatsapp/profile/{phone}



Headers:

  Authorization: Bearer YOUR_API_KEY

  Content-Type: application/json



Parâmetros:

  {phone}: Número com DDI (ex: 5511999999999)

Exemplo de Resposta (JSON)

{

  "statusCode": 200,

  "nome": "Jonas",

  "numero": "5511999999999",

  "isWhatsapp": "Sim",

  "foto": "https://pps.whatsapp.net/v/t61.24694...",

  "status": "Codando o futuro 🚀",

  "requests_left": 497,

  "apiState": "On (FlowGate)"

}

Casos de Uso

•Validar leads antes de disparos, economizando recursos.

•Enriquecer CRMs com foto e nome real do contato.

•Personalizar fluxos de Chatbot chamando o usuário pelo nome.

Integração Typebot

1.Crie um bloco HTTP Request (GET) com a URL da API.

2.Use {{numero}} do Typebot no final da URL.

3.Mapeie data.foto para uma variável e exiba no bloco Imagem.

Limites e Boas Práticas

• Rate limit: 5 req/s (burst) | 100 req/min.
• Cache (Foto): TTL ~8 min.
• Cache (Sem Dados): TTL ~3 min.

• Soft Dedup: Evita re-processamento em 20s.
• Segurança: Use API Keys apenas no Backend.
• Erros: TTL de cache de falha ~45s.