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önderinin kırpılmadan yeniden barındırılan tam görselini, 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.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 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.100000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Görev durumunu kontrol etme

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

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

Sonuç Alanları

Alan	Açıklama	Örnek
username	Gönderilen kullanıcı adı veya profil URL’si, olduğu gibi.	cristiano
activated	Bu ID için avatar görseli alınıp alınmadığı (yes/no). Kullanılabilir gönderi görseli olmayan mevcut hesaplar (gizli, gönderisiz, yüzsüz, görsel çok küçük) ve var olmayan ID’ler no olur. Yalnızca yes satırları ücretlendirilir.	yes
avatar	Yüz içeren en yeni gönderi görselinin kırpılmadan ins.waavatar.xyz üzerinde barındırılan herkese açık URL’si (süresi dolmaz). Yalnızca kenarı 500 px’ten büyük görseller verilir; profil fotoğrafları kullanılmaz. Böyle bir görsel yoksa (gizli hesap, gönderi yok, yüz yok) boştur.	https://ins.waavatar.xyz/ins/ec966a0f864e4aba1fd2899dce2c3fed.jpg
visibility	Instagram hesabının gizli olup olmadığı: private veya public; var olmayan hesaplarda boş.	public
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
verified	Hesabın onay rozeti olup olmadığı (yes/no).	yes

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.
• Verilen görsel, Instagram’ın oturum açmamış ziyaretçilere sunduğu çözünürlükte (uzun kenar 640 px) tam gönderi görselidir (kırpılmaz); yalnızca algılanan yüz bölgesi 250 px’i aştığında verilir.
• Alanlar mevcut örneğe dayanır; dışa aktarma şeması değişirse değişebilir.