Facebook ID/Kullanıcı Adı Profil API: Toplu Profil

Facebook profillerini ve sayfalarını (Pages) sayısal profil ID’si, kullanıcı adı (vanity adı) veya profil URL’si ile kontrol edin; profil fotoğrafını (kalıcı bir URL’de yeniden barındırılmış), sayısal ID’yi, standart kullanıcı adını, görünen adı, kısa sloganı ile takipçi ve “bunun hakkında konuşuyor” sayılarını alın. Ürün yalnızca oturum açmadan görülebilen herkese açık Facebook profil sayfasını okur: oturum açılmaz ve arkadaş verisi toplanmaz. Var olmayan, devre dışı bırakılmış veya oturum açmamış ziyaretçilere görünmeyen profiller etkin değil olarak döner. Görev standart eşzamansız toplu akışı kullanır.

Girdi biçimi

Her satırda bir Facebook tanımlayıcısı olan bir metin dosyası yükleyin. Kabul edilen biçimler:

• Sayısal profil ID’si, ör. 4
• Kullanıcı adı (vanity adı), ör. zuck veya @zuck; harf, rakam ve nokta, 1–50 karakter, büyük/küçük harfe duyarsız
• Profil URL’si, ör. facebook.com/zuck, facebook.com/profile.php?id=100003012457235 veya facebook.com/people/<Name>/<ID>

Profil olmayan facebook.com URL’leri (gruplar, sayfa yönetimi, giriş ve benzeri yollar) geçersiz girdi olarak reddedilir.

4
zuck
@Meta
https://www.facebook.com/profile.php?id=100003012457235
https://www.facebook.com/people/Mark-Zuckerberg/4/

Görev oluşturma

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="facebook_profile"'

API bir görev kimliği döndürür. Durumu sorgulamak için bu kimliği saklayın.

Yükleme yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "1.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Görev durumunu kontrol etme

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

status exported olana kadar sorgulayın. pending veya processing durumlarını tamamlanmış sonuç olarak değerlendirmeyin.

İşleniyor yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Dışa aktarıldı yanıtı

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "1.500000",
    "currency": "USD"
  }
}

Sonuç Alanları

Sonuç CSV dosyası şu sütunları bu sırayla içerir: username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about.

Alan	Açıklama	Örnek
username	Gönderilen tanımlayıcı (ID, kullanıcı adı veya profil URL’si), olduğu gibi.	4
activated	Herkese açık bir profil sayfasının alınıp alınmadığı (yes/no). no, profilin var olmadığı, devre dışı bırakıldığı veya oturum açmamış ziyaretçilere görünmediği anlamına gelir; Facebook üç durumda da aynı “içerik mevcut değil” sayfasını gösterdiğinden bunlar birbirinden ayırt edilemez.	yes
avatar	Profil fotoğrafının tarafımızca fb.waavatar.xyz üzerinde yeniden barındırılan kalıcı URL’si. activated no olduğunda boştur.	https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg
fb_id	Sayfadan ayrıştırılan sayısal Facebook profil ID’si.	4
fb_username	Facebook’un gösterdiği standart kullanıcı adı (vanity adı); yalnızca ID’si olan profillerde boştur.	zuck
name	Görünen ad.	Mark Zuckerberg
image	Profil fotoğrafının Facebook’a ait imzalı CDN URL’si. Birkaç gün içinde süresi dolar; kalıcı bağlantı için avatar kullanın.	https://scontent.xx.fbcdn.net/v/…jpg?…&oe=…
tagline	Sayfa açıklamasındaki kısa biyografi metni; boş olabilir.	Bringing the world closer together.
followers	Takipçi sayısı. Sayfalarda (Pages) bu, “beğeni” sayısıdır. Tam sayı; gösterilmiyorsa boş.	121439077
talking_about	Facebook’un “bunun hakkında konuşuyor” sayısı. Tam sayı; gösterilmiyorsa boş.	918893

Örnek satırlar:

username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about
4,yes,https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg,4,zuck,Mark Zuckerberg,https://scontent.xx.fbcdn.net/v/....jpg?...&oe=...,Bringing the world closer together.,121439077,918893
zzqqxxjjkk993827a,no,,,,,,,,

Hem kişisel profiller hem de sayfalar (Pages) desteklenir. Örneğin Meta, fb_id 100080376596424 olarak çözümlenir ve followers değeri sayfanın beğeni sayısıdır.

Sonuç dosyası işleme

Dosyayı yalnızca görev dışa aktarıldıktan sonra result_url adresinden indirin. İşlerken döndürülen sütun adlarını koruyun.

Yanıt alanları

Alan	Açıklama
created_at	Görevin oluşturulma zamanı.
updated_at	Son durum güncellemesinin zamanı.
task_id	Benzersiz görev kimliği.
status	pending, processing, exported veya failed.
total	İşlenen toplam girdi.
success	Başarıyla işlenen değerler.
failure	Başarısız olan değerler.
result_url	Dışa aktarma sonrası indirme URL’si.
actual_amount	Mevcutsa nihai tahsil edilen tutar.
estimated_amount	Görev oluşturulurken döndürülen tahmini tutar.

Durum kodları

Durum	Açıklama
200	İstek başarılı.
202	Görev oluşturuldu ve tahmini ücret uygulandı.
400	Geçersiz dosya, desteklenmeyen görev türü veya çok az geçerli giriş.
401	API anahtarı eksik veya geçersiz.
402	Yetersiz bakiye.
403	Ürün hesabınız için kullanılamıyor (kaldırıldı veya yalnızca beyaz liste); destekle iletişime geçin.
404	Görev bulunamadı.
413	Yüklenen dosya çok büyük.
500	Sunucu hatası; daha sonra tekrar deneyin.
503	Ürün geçici olarak kullanılamıyor (bakım); ücret alınmaz, daha sonra tekrar deneyin.

Operasyonel notlar

• Görev eşzamansızdır; durum için görev kimliğini kullanın.
• Fiyat: 10.000 tanımlayıcı başına 3 $. Ücretlendirme gönderilen miktara göredir: profil bulunsun ya da bulunmasın, gönderilen her tanımlayıcı ücretlendirilir. Görev başına en az 500 tanımlayıcı ücretlendirilir; daha küçük görevler 500 olarak ücretlendirilir.
• Sonuçlar, kontrol anındaki herkese açık profil sayfasını yansıtır. Önbellek kullanılmaz; her gönderim yeniden kontrol edilir.
• Yüklemeden önce ürünün girdi sınırlarını kontrol edin.
• Başarısız satırlar dışa aktarılan sonuçta ve sayaçlarda yer alır.
• Alanlar mevcut örneğe dayanır; kaynak sayfa yapısı değişirse değişebilir.