Voltar

Documentação ZapGet API

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

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

Endpoint de Consulta

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

GET

Estrutura da Requisição

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

Headers:
  Authorization: Bearer YOUR_API_KEY
  Content-Type: application/json
  X-Client-Origin: meusite.com

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

Exemplo de Resposta (JSON)

{
  "statusCode": 200,
  "data": {
    "name": "553588998912",
    "number": "553588998912",
    "isWhatsapp": "yes",
    "isBusiness": "false",
    "photo": "https://pps.whatsapp.net/v/t61.24694-24/308713954_497245735430196_8059092724650574447_n.jpg?ccb=11-4&oh=01_Q5Aa4wFFhtKR8yxDjI3panSjfS8b60_9kOAAI5f0SwtfNUJJ2A&oe=6A4AE409&_nc_sid=5e03e0&_nc_cat=108",
    "status": null,
    "lastseen": null,
    "jid": "553588998912@s.whatsapp.net",
    "ddd": "35",
    "region": "Brazil",
    "timestamp": "2026-06-25T20:36:48.465-03:00",
    "requests_left": 628,
    "apiState": "On"
  }
}

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

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

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

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

Limites e Boas Práticas

Rate limit: 6 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.

Aviso: Esta API utiliza tecnologia de ponte para o WhatsApp Web. Devido a atualizações constantes da Meta, instabilidades podem ocorrer. Monitoramos e atualizamos o sistema em tempo real para garantir a maior disponibilidade possível (uptime alvo: 99.8%).