# Instagram profillerini reklam kampanyası öncesinde Python ile kontrol edin: tutarsızlık raporu

https://jsonscraper.com/tr/blog/instagram-profillerini-kampanya-oncesi-kontrol-edin

Author: Michael Johnson

Published: 2026-11-19T11:42:48+00:00

Updated: 2026-11-19T11:42:48+00:00

Brief’teki hesaplar için herkese açık bilgileri alın ve kampanya başlamadan önce istisnaları içeren bir tablo oluşturun

Instagram 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.



![Makale: Instagram profillerini reklam kampanyası öncesinde Python ile kontrol edin: tutarsızlık raporu
Özet: Brief’te yanlış kullanıcı adları, fazladan boşluklar veya uygun olmayan bir profil varsa ekip bunu kampanya hazırlıkları tamamlandıktan sonra fark edebilir. Belgelenmiş jsonscraper endpoint’i üzerinden Instagram kullanıcı adlarının nasıl kontrol edileceğini ve gözlemlenen tutarsızlıkların CSV’ye nasıl aktarılacağını gösteriyoruz.
Görsel rolü: kapak — ana fikir
Bölüm: Sonuç nasıl görünecek?
Görsel konusu: Editoryal fotoğraf ](https://jsonscraper.com/assets/uploads/journal/2026/11/84aacded9a89d423a6289b53b549643f.png.hero.webp)

Rapor, kontrol edilen profil alanlarını ve kampanya başlamadan önce elle incelenmesi gereken noktaları bir araya getirir.© jsonscraper · yapay zekâyla oluşturulmuştur

 

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ş Instagram 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 [Instagram API başvuru kılavuzunda](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md) 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:



![Makale: Instagram profillerini reklam kampanyası öncesinde Python ile kontrol edin: tutarsızlık raporu
Özet: Brief’te yanlış kullanıcı adları, fazladan boşluklar veya uygun olmayan bir profil varsa ekip bunu kampanya hazırlıkları tamamlandıktan sonra fark edebilir. Belgelenmiş jsonscraper endpoint’i üzerinden Instagram kullanıcı adlarının nasıl kontrol edileceğini ve gözlemlenen tutarsızlıkların CSV’ye nasıl aktarılacağını gösteriyoruz.
Görsel rolü: destekleyici çizim 2 — farklı, belirli bir yön
Bölüm: Verileri isteyin ve raporu oluşturun
Görsel konusu: CSV’deki hesap listesinden rapora uzanan yolu gösteren şema](https://jsonscraper.com/assets/uploads/journal/2026/11/146a636928d29c035050cacd0aa101b8.png.hero.webp)

Şema, hesap listesinin bulunduğu CSV’den boş alanların boş bırakıldığı ve kurallarla eşleşmelerin ayrı ayrı işaretlendiği rapora giden yolu gösterir.© jsonscraper · yapay zekâ tarafından oluşturulmuş çizim

 

```
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 Instagram 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 [Instagram Scraper API](https://jsonscraper.com/services/ig-scraper-api) sayfasına ve [endpoint’in resmî belgelerine](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md) bakın.
