API Profil ID/Username Facebook: Profil Massal

Periksa profil dan halaman (Page) Facebook berdasarkan ID profil numerik, username (nama vanity), atau URL profil dan dapatkan foto profil (disimpan ulang di URL permanen), ID numerik, username kanonis, nama tampilan, tagline singkat, serta jumlah pengikut dan jumlah “membicarakan ini”. Produk ini hanya membaca halaman profil Facebook publik yang terlihat tanpa login: tidak ada login yang dipakai dan tidak ada data teman yang dikumpulkan. Profil yang tidak ada, dinonaktifkan, atau tidak terlihat oleh pengunjung tanpa login dikembalikan sebagai tidak aktif. Tugas ini memakai alur batch asinkron standar.

Format input

Unggah file teks dengan satu pengenal Facebook per baris. Bentuk yang diterima:

• ID profil numerik, mis. 4
• Username (nama vanity), mis. zuck atau @zuck; huruf, angka, dan titik, 1–50 karakter, tidak peka huruf besar/kecil
• URL profil, mis. facebook.com/zuck, facebook.com/profile.php?id=100003012457235, atau facebook.com/people/<Name>/<ID>

URL facebook.com yang bukan profil (grup, halaman pengelolaan, login, dan jalur serupa) ditolak sebagai entri tidak valid.

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

Membuat tugas

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 mengembalikan ID tugas. Simpan ID ini untuk memantau status.

Respons unggah

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

Memeriksa status tugas

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"'

Pantau hingga status menjadi exported. Jangan anggap pending atau processing sebagai hasil akhir.

Respons diproses

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

Respons diekspor

{
  "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"
  }
}

Kolom Hasil

CSV hasil memiliki kolom berikut, dalam urutan ini: username,activated,avatar,fb_id,fb_username,name,image,tagline,followers,talking_about.

Kolom	Deskripsi	Contoh
username	Pengenal yang dikirim (ID, username, atau URL profil) persis seperti yang dikirim.	4
activated	Apakah halaman profil publik berhasil diperoleh (yes/no). no berarti profil tidak ada, dinonaktifkan, atau tidak terlihat oleh pengunjung tanpa login; Facebook menampilkan halaman “konten tidak tersedia” yang sama untuk ketiga kasus tersebut sehingga tidak dapat dibedakan.	yes
avatar	URL permanen foto profil, disimpan ulang oleh kami di fb.waavatar.xyz. Kosong bila activated bernilai no.	https://fb.waavatar.xyz/ins/62e8bb6110133ef3115f55454ff66c4d.jpg
fb_id	ID profil Facebook numerik yang diambil dari halaman.	4
fb_username	Username kanonis (nama vanity) yang ditampilkan Facebook; kosong untuk profil yang hanya punya ID.	zuck
name	Nama tampilan.	Mark Zuckerberg
image	URL CDN bertanda tangan milik Facebook untuk foto profil. Kedaluwarsa dalam beberapa hari; gunakan avatar untuk tautan yang tahan lama.	https://scontent.xx.fbcdn.net/v/…jpg?…&oe=…
tagline	Teks bio singkat dari deskripsi halaman; bisa kosong.	Bringing the world closer together.
followers	Jumlah pengikut. Untuk Page, ini adalah jumlah “suka”. Bilangan bulat; kosong bila tidak ditampilkan.	121439077
talking_about	Jumlah “membicarakan ini” dari Facebook. Bilangan bulat; kosong bila tidak ditampilkan.	918893

Contoh baris:

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,,,,,,,,

Profil pribadi maupun Page sama-sama didukung. Misalnya, Meta dipetakan ke fb_id 100080376596424 dan nilai followers-nya adalah jumlah suka Page tersebut.

Penanganan file hasil

Unduh file dari result_url hanya setelah tugas diekspor. Pertahankan nama kolom saat memprosesnya.

Kolom respons

Kolom	Deskripsi
created_at	Waktu tugas dibuat.
updated_at	Waktu pembaruan status terakhir.
task_id	Pengenal unik tugas.
status	pending, processing, exported, atau failed.
total	Total nilai input yang diproses.
success	Nilai yang berhasil diproses.
failure	Nilai yang gagal diproses.
result_url	URL unduhan saat tugas diekspor.
actual_amount	Jumlah akhir yang ditagih, bila tersedia.
estimated_amount	Perkiraan biaya saat tugas dibuat.

Kode status

Status	Deskripsi
200	Permintaan berhasil.
202	Tugas dibuat dan biaya perkiraan diterapkan.
400	File tidak valid, jenis tugas tidak didukung, atau entri valid terlalu sedikit.
401	Kunci API tidak ada atau tidak valid.
402	Saldo akun tidak cukup.
403	Produk tidak tersedia untuk akun Anda (dihentikan atau hanya whitelist); hubungi dukungan.
404	Tugas tidak ditemukan.
413	File yang diunggah terlalu besar.
500	Kesalahan server internal; coba lagi nanti.
503	Produk sementara tidak tersedia (jeda pemeliharaan); tidak ada biaya, coba lagi nanti.

Catatan operasional

• Tugas bersifat asinkron; gunakan ID tugas untuk memantau status.
• Harga: $3 per 10.000 pengenal. Penagihan berdasarkan jumlah yang dikirim: setiap pengenal yang dikirim ditagih, baik profil ditemukan maupun tidak. Jumlah minimum yang ditagih per tugas adalah 500 pengenal; tugas yang lebih kecil ditagih sebagai 500.
• Hasil mencerminkan halaman profil publik pada saat pemeriksaan. Tidak ada cache yang dipakai; setiap pengiriman diperiksa ulang.
• Periksa batas input produk sebelum mengunggah.
• Baris yang gagal dilaporkan di hasil ekspor dan penghitung tugas.
• Kolom di atas berdasarkan sampel saat ini dan dapat berubah bila struktur halaman hulu berubah.