API Profil ID/Username Instagram: Profil Massal

Periksa akun Instagram berdasarkan username (ID) atau URL profil dan dapatkan gambar utuh postingan terbaru yang berisi wajah, disimpan ulang tanpa dipotong, 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.

ID numerik Instagram (pk) juga diterima dan akan dipetakan ke username.

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

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.100000",
    "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.100000",
    "currency": "USD"
  }
}

Kolom Hasil

Kolom	Deskripsi	Contoh
username	Username atau URL profil persis seperti yang dikirim.	cristiano
activated	Apakah gambar avatar diperoleh untuk ID ini (yes/no). Akun yang ada tetapi tanpa gambar postingan yang dapat dipakai (privat, tanpa postingan, tanpa wajah, gambar terlalu kecil) dan ID yang tidak ada bernilai no. Hanya baris yes yang ditagih.	yes
avatar	URL publik gambar postingan terbaru yang berisi wajah, disimpan ulang tanpa dipotong di ins.waavatar.xyz (tidak kedaluwarsa). Hanya gambar dengan sisi lebih dari 500 px yang dikirim; foto profil tidak dipakai. Kosong bila tidak ada gambar seperti itu (akun privat, tanpa postingan, tanpa wajah).	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Apakah akun Instagram privat: private atau public; kosong untuk akun yang tidak ada.	public
ig_username	Username Instagram hasil resolusi (juga diisi bila nilai yang dikirim adalah ID numerik); kosong untuk akun yang tidak ada.	villavicenciopaul
full_name	Nama yang ditampilkan di profil.	Cristiano Ronaldo
posts	Jumlah postingan.	4138
followers	Jumlah pengikut.	679725371
following	Jumlah yang diikuti.	636
verified	Apakah akun memiliki lencana terverifikasi (yes/no).	yes

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.
• Gambar yang dikirim adalah gambar postingan utuh (tanpa pemotongan) pada resolusi yang disajikan Instagram tanpa login (640 px sisi terpanjang); hanya dikirim bila area wajah yang terdeteksi melebihi 250 px.
• Kolom di atas berdasarkan sampel saat ini dan dapat berubah bila skema ekspor hulu berubah.