jsonscraper
Piyasalar
Dergiye dön

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

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

Yayın Politikası Hata bildirin

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.

Makale: IG 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 IG 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
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ş 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:

Makale: IG 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 IG 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
Ş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 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.

İnsanlar

Bu makale için henüz kimse listelenmedi.

Okumaya devam etCRM’ye Aktarmadan Önce TikTok Potansiyel Müşterilerini IG’da Nasıl Kontrol Edersiniz?
Sonraki makaleyi okuyun

Okuduklarınızı çalışan bir entegrasyona dönüştürün

jsonscraper sosyal veri API'lerini keşfedin, istekleri test edin ve sonraki iş akışınızı oluşturun.

API'leri Keşfet