IG hesaplarını kampanya başlamadan önce kontrol etmek, yerleştirme listesindeki hataları düzeltmeleri hâlâ kolayken bulmaya yardımcı olur. Örneğin brief’te bir kullanıcı adı yanlış yazılmış, bir hesap yinelenmiş veya beklenmedik sayıda takipçisi olan bir profil yer alıyor olabilir. Aşağıda, her kullanıcı adı için herkese açık verileri isteyen, yanıtı belirttiğiniz koşullarla karşılaştıran ve kontrol edilebilir satırları CSV’ye kaydeden küçük bir Python betiği var.
Sonuç nasıl görünecek?
Girdi olarak hesap listesini ve isteğe bağlı beklenen değerleri içeren bir CSV verilir. Çıktıda, işlenen her kullanıcı adı için ayrı bir satır bulunur: istek durumu, profil adı, doğrulanma işareti, takipçi, gönderi ve takip edilen hesap sayıları ile bulunan tutarsızlıkların kısa bir listesi.

Bu rapor, iş ortaklarını brief’le karşılaştıran pazarlama uzmanları ve düzenli bir göreve dönüştürülebilecek dahili bir kontrol oluşturan geliştiriciler için yararlıdır. Bu, herkese açık profilin belirli alanlarının istek anındaki kontrolüdür; kampanyaya uygun olup olmadığına ekip karar verir.
Hangi alanlar kontrol edilebilir?
Belgelenmiş IG API rotası /v1/user/by/username, zorunlu username parametresini kabul eder. Gözlemlenen yanıt biçiminde profil verileri ig nesnesinde bulunur; döndürülen alanlar arasında username, full_name, is_private, is_verified, media_count, follower_count, following_count ve biography yer almıştır. Alanlar yanıtta bulunmayabileceğinden, aşağıdaki betik eksik değerleri boş bırakır ve bunları sıfıra dönüştürmez. Rotaların ve parametre adlarının listesi IG API başvuru kılavuzunda verilmiştir.
Kontrol, açıkça ifade edilebilen koşullar için özellikle kullanışlıdır: profil herkese açık olmalı, takipçi sayısı belirlenen aralıkta bulunmalı ve doğrulanma işareti brief’teki gereklilikle eşleşmelidir. Biyografi daha sonra incelenmek üzere kaydedilebilir; ancak metni pazarlama konumlandırmasıyla otomatik olarak karşılaştırmak için ayrı bir ölçüt gerekir.
Girdi dosyasını hazırlayın
UTF-8 biçiminde profiles.csv oluşturun. En basit sürüm yalnızca kullanıcı adını içerir; brief’te ilgili bir kısıtlama yoksa ek beklenen alanları boş bırakın:
username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true
min_followers ve max_followers değerleri kontrol sınırlarını belirler. verified alanı true veya false değerini kabul eder. Her profil için yalnızca geçerli koşulları belirtebilirsiniz.
Verileri isteyin ve raporu oluşturun
requests paketini yükleyin ve anahtarı kaynak dosyaya değil, işlem ortamına tanımlayın. macOS veya Linux’ta komut şu şekildedir:

python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='anahtarınız'
Aşağıdaki betiği check_profiles.py adıyla kaydedin. Python 3.8 ve üzerini kullanır, yanıtın HTTP durumunu kontrol eder, ig veri yükünü ayrı olarak okur ve profile_check.csv dosyasını oluşturur. Hizmet belgelerinde belirtildiği gibi anahtar, license_key sorgu parametresi olarak iletilir.
import csv
import os
import sys
from typing import Dict, List, Optional
import requests
API_URL = "https://ig.jsonscraper.com/v1/user/by/username"
API_KEY = os.environ.get("JSONSCRAPER_INSTAGRAM_LICENSE_KEY")
if not API_KEY:
raise SystemExit("JSONSCRAPER_INSTAGRAM_LICENSE_KEY değerini ayarlayın")
def parse_bool(value: str) -> Optional[bool]:
normalized = value.strip().lower()
if normalized in ("true", "1", "yes", "да"):
return True
if normalized in ("false", "0", "no", "нет"):
return False
return None
def check_row(row: Dict[str, str]) -> Dict[str, str]:
username = row.get("username", "").strip().lstrip("@")
result = {
"requested_username": username,
"status": "",
"returned_username": "",
"full_name": "",
"is_private": "",
"is_verified": "",
"follower_count": "",
"media_count": "",
"following_count": "",
"biography": "",
"issues": "",
}
if not username:
result["status"] = "skipped_empty_username"
result["issues"] = "empty_username"
return result
try:
response = requests.get(
API_URL,
params={"license_key": API_KEY, "username": username},
timeout=30,
)
response.raise_for_status()
payload = response.json()
except (requests.RequestException, ValueError) as exc:
result["status"] = "request_error"
result["issues"] = type(exc).__name__
return result
if payload.get("status") != "ok":
result["status"] = "api_error"
result["issues"] = "unexpected_outer_status"
return result
profile = payload.get("ig")
if not isinstance(profile, dict):
result["status"] = "missing_profile_data"
result["issues"] = "missing_ig_object"
return result
result["status"] = "ok"
fields = (
"username", "full_name", "is_private", "is_verified",
"follower_count", "media_count", "following_count", "biography",
)
for field in fields:
value = profile.get(field)
if value is not None:
result["returned_username" if field == "username" else field] = str(value)
issues: List[str] = []
private = profile.get("is_private")
if private is True:
issues.append("private_profile")
followers = profile.get("follower_count")
if isinstance(followers, int):
minimum = row.get("min_followers", "").strip()
maximum = row.get("max_followers", "").strip()
if minimum:
try:
if followers < int(minimum):
issues.append("below_min_followers")
except ValueError:
issues.append("invalid_min_followers_rule")
if maximum:
try:
if followers > int(maximum):
issues.append("above_max_followers")
except ValueError:
issues.append("invalid_max_followers_rule")
elif row.get("min_followers", "").strip() or row.get("max_followers", "").strip():
issues.append("follower_count_unavailable")
expected_verified = parse_bool(row.get("verified", ""))
actual_verified = profile.get("is_verified")
if expected_verified is not None and isinstance(actual_verified, bool):
if actual_verified != expected_verified:
issues.append("verified_flag_mismatch")
elif row.get("verified", "").strip():
issues.append("verified_value_unavailable_or_invalid")
result["issues"] = ";".join(issues)
return result
with open("profiles.csv", newline="", encoding="utf-8-sig") as source:
rows = list(csv.DictReader(source))
output = [check_row(row) for row in rows]
fieldnames = list(output[0].keys()) if output else [
"requested_username", "status", "returned_username", "full_name",
"is_private", "is_verified", "follower_count", "media_count",
"following_count", "biography", "issues",
]
with open("profile_check.csv", "w", newline="", encoding="utf-8") as destination:
writer = csv.DictWriter(destination, fieldnames=fieldnames)
writer.writeheader()
writer.writerows(output)
print(f"İşlenen satır sayısı: {len(output)}; rapor: profile_check.csv")
Tutarsızlık içeren satırlar nasıl okunur?
python check_profiles.py komutunu çalıştırın. status sütunundaki ok değeri, betiğin beklenen profil nesnesini aldığını ve bir kayıt oluşturabildiğini gösterir. issues sütunu yalnızca kontrol edilen kuralları içerir: örneğin private_profile veya below_min_followers. Sütunun boş olması, kaydedilen koşulların bir tutarsızlık ortaya çıkarmadığı anlamına gelir; içerik kalitesini veya sözleşmenin diğer maddelerine uygunluğu doğrulamaz.
returned_username değerini kaynak kullanıcı adıyla karşılaştırın; anlamsal inceleme için biography ve full_name alanlarını ilgili çalışana iletin. Raporda ayrıca istek hataları, beklenmeyen API durumları ve ig nesnesinin bulunmaması da yer alır. Bu satırlar örneklemde kalır ve teknik arızayı kontrol sonucundan ayırt etmeye yardımcı olur.
Kontrol düzenli olarak nasıl çalıştırılır?
Tek seferlik bir kontrol için betiği elle çalıştırmanız yeterlidir. Düzenli bir süreçte betiği bir zamanlayıcıya veya CI iş akışına ekleyin: güncel listeyi yükleyin, istekleri çalıştırın, CSV’yi bir çıktı dosyası olarak kaydedin ve issues sütununda değerler oluşursa ekibi bilgilendirin. Anahtarı günlüklere yazdırmayın; çalışma ortamında gizli bilgi olarak saklayın.
Aynı profilleri sık sık kontrol ediyorsanız cache_timeout parametresini saniye cinsinden bir önbellek süresi olarak iletebilirsiniz. Belgelerde IG için önbelleğin varsayılan olarak kapalı olduğu belirtiliyor; sıfırdan büyük bir değer, önbelleği belirtilen süre boyunca etkinleştirir. Bu parametreyi yalnızca seçilen aralıkta yanıtın yeniden kullanılmasına izin veriliyorsa ekleyin.
Yalnızca erişim hakkınız olan verileri ve kullanım senaryolarını kontrol edin. Sonucu belirli bir API yanıtının anlık görüntüsü olarak değerlendirin, çalıştırma tarihini kendi günlüğünüzde kaydedin ve eşikleri brief’le birlikte gözden geçirin. Rota, kullanılabilir alanlar ve entegrasyon seçenekleri hakkında ayrıntılar için IG Scraper API sayfasına ve endpoint’in resmî belgelerine bakın.