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

Instagram hesaplarını kullanıcı adı (ID) veya profil URL’si ile kontrol edin; yüz içeren en yeni gönderiden kırpılıp yeniden barındırılan yüz fotoğrafını, tam adı, gönderi sayısını, takipçi ve takip edilen sayılarını ve hesabın gizli ya da onaylı olup olmadığını alın. Var olmayan hesaplar etkin değil olarak döner; gizli hesaplar profil alanlarıyla etkin olarak döner ancak fotoğraf içermez. Görev standart eşzamansız toplu akışı kullanır.

Girdi biçimi

Her satırda bir Instagram kullanıcı adı (ID) olan bir metin dosyası yükleyin. username, @username ve tam instagram.com/<username> URL’leri kabul edilir; eşleştirme büyük/küçük harfe duyarsızdır.

Sayısal Instagram ID’leri (pk) de kabul edilir ve kullanıcı adına çözümlenir.

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

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="instagram_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.250000",
    "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.250000",
    "currency": "USD"
  }
}

Sonuç Alanları

Alan	Açıklama	Örnek
username	Gönderilen kullanıcı adı veya profil URL’si, olduğu gibi.	cristiano
activated	Hesabın var olup olmadığı (no = böyle bir kullanıcı adı yok).	yes
avatar	Yüz içeren en yeni gönderiden kırpılan ve ins.waavatar.xyz üzerinde barındırılan yüz fotoğrafının herkese açık URL’si (süresi dolmaz); yüz bulunamazsa, hesap gizliyse veya gönderi yoksa boştur.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
ig_username	Çözümlenen Instagram kullanıcı adı (gönderilen değer sayısal ID olsa da doldurulur); var olmayan hesaplarda boştur.	villavicenciopaul
full_name	Profilde gösterilen ad.	Cristiano Ronaldo
posts	Gönderi sayısı.	4138
followers	Takipçi sayısı.	679725371
following	Takip edilen sayısı.	636
private	Hesabın gizli olup olmadığı (yes/no).	no
verified	Hesabın onay rozeti olup olmadığı (yes/no).	yes
face_status	Yüz çıkarma sonucu: ok (kırpma 400 px’ten büyük), ok_small (küçük yüz korundu), no_face, no_640_face (en az 640 px gönderi görseli yok), private, empty (gönderi yok), posts_missed.	ok

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.
• 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.
• Fotoğraflar, Instagram’ın oturum açmamış ziyaretçilere sunduğu çözünürlükte (640 px) herkese açık gönderilerden kırpılır; bu nedenle çoğu kırpma 400 px altındadır ve ok_small olarak işaretlenir.
• Alanlar mevcut örneğe dayanır; dışa aktarma şeması değişirse değişebilir.