Guida rapida: prima ricerca del profilo in 10 minuti.

Passaggio 1: ottenere una chiave API

Due canali: scegline uno. Stesso JSON, stessi endpoint, diversa origine della chiave e URL di base:

Una chiave diretta NON funzionerà con l'URL base di RapidAPI e viceversa. Il nome dell'intestazione x-rapidapi-key viene riutilizzato in entrambi i casi per garantire la compatibilità: ciò che conta è la sorgente del valore.

Passaggio 2: Fai la tua prima richiesta

Delega diretta (consigliata):

curl -H "x-rapidapi-key: YOUR_DIRECT_KEY" \
  "https://whatsapp-proxy.checkleaked.cc/number/13105551234"

Mercato RapidAPI:

curl -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: whatsapp-data1.p.rapidapi.com" \
  "https://whatsapp-data1.p.rapidapi.com/number/13105551234"

Passaggio 3 — Leggi la risposta

La risposta è un documento WhatsAppEntry (formato live - campi extra rimossi):

{
  "number": "13105551234",
  "countryCode": "US",
  "phone": "+1 310 555 1234",
  "type": "FIXED_LINE_OR_MOBILE",
  "about": null,
  "isWAContact": true,
  "isUser": true,
  "isBusiness": true,
  "isGroup": false,
  "isBlocked": false,
  "isMyContact": false,
  "isEnterprise": false,
  "isVerified": false,
  "id": {
    "server": "c.us",
    "user": "13105551234",
    "_serialized": "[email protected]"
  },
  "businessProfile": {
    "categories": [{ "id": "...", "localized_display_name": "Otra categoría" }],
    "memberSinceText": "Se unió en abril, 2024.",
    "isProfileLocked": true
  },
  "profilePic": { "success": false, "image_status": "item-not-found" },
  "date": "2026-04-10T17:30:33.356Z",
  "cached": true
}

Note tratte dai test sul campo:

• profilePic è un OGGETTO, non un URL. Se esiste un'immagine, recupera il file binario tramite /picture/{number}; se non è presente, ottieni { success: false, image_status: "item-not-found" }.
• about è nullo quando ristretto.
• isWAContact è l'indicatore canonico "questo numero è su WhatsApp?".
• I risultati mancati nella ricerca restituiscono comunque un WhatsAppEntry: controlla i campi error/exists, non solo lo stato HTTP.

Passaggio 4 — Gestione degli errori

Gli errori relativi al limite di burst e all'autenticazione restituiscono un corpo breve:

{ "error": "Requests must be at least 0.5 seconds apart" }

Intervallo predefinito: almeno 500 ms tra le richieste (2 richieste/sec). Livello MEGA: 250 ms (4 richieste/sec). Riferimento completo agli errori.

Flag di query opzionali su /number/{number}

Prossimi passi