WA Lookup
Başvuru

WA Lookup API başvurusu

Tüm uç noktalar tek bir API anahtarını ve tek bir bakiyeyi paylaşır.

ÖğeDeğer
Temel URLhttps://walookup.com
Kimlik doğrulama başlığıX-API-Key: sk_your_api_key
Yanıt zarfı{ code, msg, data }

Fiyatlar burada listelenmez; her ürün başarılı kontrol başına ücretlendirilir. Fiyatlandırmayı görün

Kimlik doğrulama

Ayarlar'da oluşturulan bir API anahtarı kullanın ve bunu her istekte X-API-Key başlığıyla gönderin.

Kimlik doğrulama başlığı
X-API-Key: sk_your_api_key

API anahtarınızı gizli tutunBu uç noktayı her zaman sunucunuzdan çağırın. Anahtara sahip olan herkes bakiyenizi harcayabilir.

Senkron kontroller

POST/api/v1/checkPOST/api/v1/batch-check

Bir tanımlayıcı veya tek istekte en fazla 100 tanımlayıcı gönderin ve sonucu aynı yanıtta okuyun. Yoklama yok, geri çağırma yok. Belirlenemeyen bir sonuç 42200 koduyla 422 döndürür ve ücretlendirilmez. Çoklu istek girdi sırasını korur, her tanımlayıcıyı bağımsız olarak ücretlendirir ve tamamlanmak için 300 saniyesi vardır — tamamlanmazsa isteğin tamamı başarısız olur ve tüm ücretler iade edilir.

Parametreler

AlanTürAçıklama
service_typestringÜrün kodu; aşağıda listelenen ürünlerden biri.
identifierstringTekli kontrol: başında + olan veya olmayan, E.164 biçiminde bir telefon numarası. Sunucu bunu normalleştirir.
identifiersstring[]Çoklu kontrol: 1 ila 100 telefon numarası. Yanıt bu sırayı korur.

Bu gruptaki ürünler

WhatsApp Kayıt Kontrolü

wstelefon

Bir numaranın WhatsApp'ta kayıtlı olup olmadığını doğrulayın — göndermeden önce kişi listesini kontrol etmek için kullanışlıdır.

Tekli kontrol

POST/api/v1/check
İstek
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws", "identifier": "+17253100591" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws",
    "identifier": "+17253100591",
    "registered": true
  }
}
Yanıt alanları
AlanTürAçıklama
registeredbooleanNumaranın WhatsApp'ta kayıtlı olup olmadığı.

Çoklu kontrol

POST/api/v1/batch-check
İstek
curl -X POST "https://walookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws", "identifiers": ["+17253100591", "+14155550000", "12345"] }'
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}
Yanıt alanları
AlanTürAçıklama
existsbooleanBu numaranın bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri bulunmaz.
registeredbooleanNumaranın registered olup olmadığı. Yalnızca exists true olduğunda bulunur ve tekli kontroldekiyle aynı anlamı taşır.

WhatsApp Profil Fotoğrafı Kontrolü

ws_avatartelefon

Bir numaranın WhatsApp'ta kayıtlı olup olmadığını kontrol edin ve profil fotoğrafı alanlarını döndürün: avatar (fotoğraf alınıp alınmadığı) ve avatar_url.

Tekli kontrol

POST/api/v1/check
İstek
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifier": "+17253100591" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "identifier": "+17253100591",
    "registered": true,
    "avatar": true,
    "avatar_url": "<image url>"
  }
}
Yanıt alanları
AlanTürAçıklama
registeredbooleanNumaranın WhatsApp'ta kayıtlı olup olmadığı.
avatarbooleanHesapta profil fotoğrafı ayarlanıp ayarlanmadığı. Görsel mevcut olmadığında avatar_url yine de boş olabilir.
avatar_urlstringProfil fotoğrafı URL'si; URL mevcut olmadığında boş bir dize.

Çoklu kontrol

POST/api/v1/batch-check
İstek
curl -X POST "https://walookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_avatar", "identifiers": ["+17253100591", "+14155550000", "12345"] }'
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_avatar",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "<image url>"
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": ""
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}
Yanıt alanları
AlanTürAçıklama
existsbooleanBu numaranın bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri bulunmaz.
registeredbooleanNumaranın registered olup olmadığı. Yalnızca exists true olduğunda bulunur ve tekli kontroldekiyle aynı anlamı taşır.
avatarbooleanHesapta profil fotoğrafı ayarlanıp ayarlanmadığı. Görsel mevcut olmadığında avatar_url yine de boş olabilir.
avatar_urlstringProfil fotoğrafı URL'si; URL mevcut olmadığında boş bir dize.

WhatsApp Business Hesabı Kontrolü

ws_businesstelefon

Kaydı kontrol edin ve numaranın WhatsApp Business hesabı kullanıp kullanmadığını belirleyin.

Tekli kontrol

POST/api/v1/check
İstek
curl -X POST "https://walookup.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_business", "identifier": "+17253100591" }'
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_business",
    "identifier": "+17253100591",
    "registered": true,
    "business": true
  }
}
Yanıt alanları
AlanTürAçıklama
registeredbooleanNumaranın WhatsApp'ta kayıtlı olup olmadığı.
businessbooleanHesabın bir WhatsApp Business hesabı olup olmadığı.

Çoklu kontrol

POST/api/v1/batch-check
İstek
curl -X POST "https://walookup.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "ws_business", "identifiers": ["+17253100591", "+14155550000", "12345"] }'
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "ws_business",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "+17253100591",
        "exists": true,
        "registered": true,
        "business": true
      },
      {
        "identifier": "+14155550000",
        "exists": true,
        "registered": false,
        "business": false
      },
      {
        "identifier": "12345",
        "exists": false
      }
    ]
  }
}
Yanıt alanları
AlanTürAçıklama
existsbooleanBu numaranın bir sonuç üretip üretmediği. false, biçimin geçersiz olduğu, sonucun belirlenemediği veya kontrolün başarısız olduğu anlamına gelir; false olduğunda aşağıdaki alanların hiçbiri bulunmaz.
registeredbooleanNumaranın registered olup olmadığı. Yalnızca exists true olduğunda bulunur ve tekli kontroldekiyle aynı anlamı taşır.
businessbooleanHesabın bir WhatsApp Business hesabı olup olmadığı.

Asenkron kontroller

POST/api/v1/bulk-tasksGET/api/v1/bulk-tasks/{id}

Bir dosya yükleyin ve hemen bir görev kimliği alın, ardından bu kimliği başarılı olana kadar kontrol edin. Başarılı yanıt, sonuç indirme bağlantısı olan result_url alanını içerir. Yalnızca iki işlem vardır: gönder ve kontrol et. 30 saniyede bir defadan daha sık yoklama yapmayın.

Parametreler

AlanTürAçıklama
service_typestringToplu ürün kodu; aşağıda listelenen ürünlerden biri.
countrystringUS gibi bir ISO 3166-1 kodu. Numara görevleri için zorunludur: her numara ülke kodunu içermeli ve bu ülkeye ait olmalıdır (uymayan numaralar çıkarılır ve ücretlendirilmez); ayrıca yönlendirmeyi de belirler. Multipart'ta file alanından önce gelmelidir.
filefileHer satırda bir tanımlayıcı bulunan, en fazla max_file_bytes (varsayılan 20MB) boyutunda bir .txt veya .csv dosyası.
Idempotency-Keyheaderİsteğe bağlı, en fazla 128 karakter. Aynı anahtarın tekrar gönderilmesi ikinci bir görev oluşturmak yerine orijinal görevi döndürür.

Bu gruptaki ürünler

WhatsApp Toplu Kayıt Kontrolü

ws_batchtelefonGörev başına 1.000–500.000

Numaralardan oluşan bir dosyanın tamamını yükleyin, hangilerinin WhatsApp'ta kayıtlı olduğunu öğrenin ve tamamlandığında sonuç dosyasını indirin.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifier17253100591Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
activatedtrueNumaranın WhatsApp'ta kayıtlı olup olmadığı: true veya false.

WhatsApp Toplu Profil Fotoğrafı Kontrolü

ws_avatar_batchtelefonGörev başına 1.000–500.000

Bütün bir listeyi WhatsApp kaydı ve profil fotoğrafı açısından kontrol edin: kayıtlı her numarada profil fotoğrafı ayarlanıp ayarlanmadığı ve profil fotoğrafı URL'si.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_avatar_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_avatar_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_avatar_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifier17253100591Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
activatedtrueNumaranın WhatsApp'ta kayıtlı olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
avatartrueHesapta profil fotoğrafı ayarlanıp ayarlanmadığı: true veya false. Görsel mevcut olmadığında avatar_url yine de boş olabilir.
avatar_urlhttps://pps.whatsapp.net/v/example.jpgProfil fotoğrafı URL'si; URL mevcut olmadığında boştur.

WhatsApp Toplu Business Kontrolü

ws_business_batchtelefonGörev başına 1.000–500.000

Bütün bir listeyi WhatsApp Business hesapları açısından kontrol edin: her numaranın WhatsApp'ta olup olmadığı ve bu hesabın bir WhatsApp Business hesabı olup olmadığı.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_business_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_business_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_business_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifier17253100591Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
activatedtrueNumaranın WhatsApp'ta kayıtlı olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
businessfalseHesabın bir WhatsApp Business hesabı olup olmadığı: true veya false.

WhatsApp Toplu Etkinlik Kontrolü

ws_active_batchtelefonGörev başına 1.000–500.000

Kayıt durumu ile birlikte aktif günler — numaranın son etkin olmasından bu yana geçen gün sayısı — böylece bütün bir listede canlı numaraları uykudakilerden ayırabilirsiniz.

Görev gönder

POST/api/v1/bulk-tasks
İstek
curl -X POST "https://walookup.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=ws_active_batch \
  -F country=US \
  -F file=@numbers.txt
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_active_batch",
    "status": "processing",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1015,
    "invalid_cnt": 0,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 0,
    "preparing": true,
    "created_at": "2026-09-08T09:30:00Z"
  }
}

Görevi kontrol et

GET/api/v1/bulk-tasks/{id}
İstek
curl "https://walookup.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "ws_active_batch",
    "status": "success",
    "country": "US",
    "submitted_lines": 1015,
    "total": 1000,
    "invalid_cnt": 3,
    "no_code_cnt": 0,
    "other_country_cnt": 0,
    "duplicate_cnt": 12,
    "preparing": false,
    "success_cnt": 990,
    "failure_cnt": 10,
    "result_url": "https://…/result.csv",
    "created_at": "2026-09-08T09:30:00Z"
  }
}
Sonuç sütunları
Alanörnek:Açıklama
identifier17253100591Gönderilen numara; ülke koduyla birlikte, artı işareti veya boşluk olmadan yalnızca rakamlar (ör. 17253100591).
activatedtrueNumaranın WhatsApp'ta kayıtlı olup olmadığı: true veya false. true olmadığında o satırdaki diğer tüm sütunlar boş bırakılır.
activedays9Numaranın son etkin olmasından bu yana geçen gün sayısı — küçük değer daha yakın zamanı gösterir.

Bakiye

GET/api/v1/balance

Mevcut hesap bakiyesini USD mikro birimi cinsinden okuyun. Salt okunurdur: kontrol kaydı oluşturmaz ve ücret almaz.

Bakiye

GET/api/v1/balance
İstek
curl "https://walookup.com/api/v1/balance" \
  -H "X-API-Key: sk_your_api_key"
Yanıt
{
  "code": 0,
  "msg": "ok",
  "data": {
    "balance_micros": 12500000
  }
}

Eşzamanlılık, zaman aşımları ve yeniden deneme davranışı

Kontroller senkrondur. Sonucu kabul etmeye mi yoksa yeniden denemeye mi karar vereceğinizi döndürülen koda göre belirleyin.

AlanAçıklama
Kullanıcı başına aynı anda 5 istekTekli ve çoklu kontroller bu sınırı paylaşır ve bir çoklu istek, kaç numara içerirse içersin tek bir istek sayılır. Buna ek olarak, hesap başına aynı anda yalnızca bir çoklu kontrol çalışır; ilki bitene kadar ikincisi reddedilir. Herhangi bir sınıra ulaşıldığında ücret alınmadan hemen code 42901 ve bir Retry-After başlığı döner — devam eden bir istek bittiğinde yeniden gönderin.
Tekli 60 sn, çoklu 300 snSüre sınırının aşılması ücret alınmadan code 50400 döndürür. Zaman aşımına uğrayan bir çoklu kontrol bütünüyle başarısız olur — kısmi sonuç verilmez ve tutarın tamamı iade edilir.
Bir çoklu kontrol en fazla 100 numara alırSonuçlar gönderim sırasını ve uzunluğunu korur. Hesap başına aynı anda bir çoklu kontrol çalışır; bir önceki grup döndükten sonra sonraki grubu gönderin.

Hata kodları

KodAçıklama
40000Desteklenmeyen hizmet türü veya çelişen istek alanları
40001Geçersiz JSON gövdesi
40002Geçersiz numara
40100Eksik veya geçersiz API anahtarı
40200Yetersiz bakiye
42200Numara şu anda belirlenemedi. data döndürülmez ve istek ücretlendirilmez
42900Bir kullanım kotası tükendi veya tamamlanmamış sipariş sayısı çok fazla
42901Beş eşzamanlı istek yuvasının tamamı dolu veya bu hesapta zaten bir çoklu kontrol çalışıyor; devam eden bir istek bittikten sonra gönderin. Reddedilen istek ücretlendirilmez ve bir Retry-After başlığı içerir
50303Hizmet şu anda tam kapasitede; ücret alınmaz. Retry-After saniye kadar bekleyin ve aynı isteği yeniden gönderin
50400Kontrol zaman aşımı süresi içinde tamamlanmadı ve ücretlendirilmez; yeniden deneyin. Grup zaman aşımında grubun tamamı başarısız olur ve tutarın tamamı iade edilir
50300Doğrulama hizmeti bakımda