API Profil ID/Username Instagram: Profil Massal

Periksa akun Instagram berdasarkan username (ID) atau URL profil dan dapatkan foto wajah yang dipotong dari postingan terbaru yang berisi wajah lalu disimpan ulang, nama lengkap, jumlah postingan, jumlah pengikut dan yang diikuti, serta apakah akun privat atau terverifikasi. Akun yang tidak ada dikembalikan sebagai tidak aktif; akun privat dikembalikan sebagai aktif dengan data profil tanpa foto. Tugas ini memakai alur batch asinkron standar.

Format input

Unggah file teks dengan satu username (ID) Instagram per baris. username, @username, dan URL lengkap instagram.com/<username> diterima; pencocokan tidak peka huruf besar/kecil.

cristiano
@zuck
https://www.instagram.com/natgeo/

Membuat tugas

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

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

API mengembalikan ID tugas. Simpan ID ini untuk memantau status.

Respons unggah

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

Memeriksa status tugas

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

curl --location 'https://api.numberchecker.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.250000",
    "currency": "USD"
  }
}

Kolom Hasil

Kolom	Deskripsi	Contoh
username	Username atau URL profil persis seperti yang dikirim.	cristiano
activated	Apakah akun ada (no = username tidak ada).	yes
avatar	URL publik foto wajah yang dipotong dari postingan terbaru berwajah, disimpan ulang di ins.waavatar.xyz (tidak kedaluwarsa); kosong jika tidak ada wajah, akun privat, atau tidak ada postingan.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
full_name	Nama yang ditampilkan di profil.	Cristiano Ronaldo
posts	Jumlah postingan.	4138
followers	Jumlah pengikut.	679725371
following	Jumlah yang diikuti.	636
private	Apakah akun privat (yes/no).	no
verified	Apakah akun memiliki lencana terverifikasi (yes/no).	yes
face_status	Hasil ekstraksi wajah: ok (potongan lebih dari 400 px), ok_small (wajah kecil tetap disimpan), no_face, no_640_face (tidak ada gambar minimal 640 px), private, empty (tanpa postingan), posts_missed.	ok

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.
• Periksa batas input produk sebelum mengunggah.
• Baris yang gagal dilaporkan di hasil ekspor dan penghitung tugas.
• Foto dipotong dari postingan publik pada resolusi yang disajikan Instagram untuk pengunjung tanpa login (640 px), sehingga sebagian besar potongan di bawah 400 px dan ditandai ok_small.
• Kolom di atas berdasarkan sampel saat ini dan dapat berubah bila skema ekspor hulu berubah.