jsonscraper
שווקים
חזרה ליומן

בדיקת פרופילי IG לפני קמפיין פרסום: דוח אי־התאמות ב-Python

אחזרו מידע ציבורי על חשבונות מתוך הבריף וצרו טבלת חריגים לפני השקת הקמפיין

מדיניות עריכה דיווח על שגיאה

בדיקת חשבונות IG לפני השקת הקמפיין עוזרת לאתר שגיאות ברשימת הפרסומים, כשעדיין קל לתקן אותן. למשל, הבריף מכיל שגיאת הקלדה בשם משתמש, חשבון כפול או פרופיל עם מספר עוקבים בלתי צפוי. להלן סקריפט Python קצר ששולח בקשה לקבלת נתונים ציבוריים עבור כל username, משווה את התשובה לתנאים שלכם ושומר את השורות שנבדקו בקובץ CSV.

מה יתקבל

הקלט הוא קובץ CSV עם רשימת חשבונות וערכים צפויים אופציונליים. הפלט הוא שורה נפרדת לכל username שעובד: סטטוס הבקשה, שם הפרופיל, סימון האימות, מספר העוקבים, הפוסטים והחשבונות במעקב, וכן רשימה קצרה של אי־ההתאמות שנמצאו.

מאמר: בדיקת פרופילי IG לפני קמפיין פרסום: דוח אי־התאמות ב-Python
תקציר: אם הבריף כולל שמות חשבונות שגויים, רווחים מיותרים או פרופיל לא מתאים, הצוות עלול לגלות זאת רק לאחר הכנת הקמפיין. כך בודקים שמות משתמש ב-IG באמצעות נקודת הקצה המתועדת של jsonscraper ומייצאים ל-CSV את אי־ההתאמות שנצפו.
תפקיד התמונה: תמונת שער — הרעיון המרכזי
מקטע: מה יתקבל
נושא חזותי: צילום מערכת מערכת טעינה
הדוח מרכז את שדות הפרופיל שנבדקו ואת ההערות לבדיקה ידנית לפני השקת הקמפיין.© jsonscraper · נוצר באמצעות AI

דוח כזה מועיל לאיש שיווק שמשווה בין ספקים לבריף, וגם למפתח שבונה בדיקה פנימית כחלק ממשימה מחזורית. זוהי בדיקה של שדות מסוימים בפרופיל ציבורי בזמן הבקשה; ההחלטה הידנית אם הפרופיל מתאים לקמפיין נותרת בידי הצוות.

אילו שדות אפשר לבדוק

הנתיב המתועד של IG API‏ /v1/user/by/username מקבל את הפרמטר החובה username. במבנה התשובה שנצפה, נתוני הפרופיל נמצאים באובייקט ig; השדות שהוחזרו כללו את username, full_name, is_private, is_verified, media_count, follower_count, following_count ו-biography. השדות עשויים שלא להופיע תמיד, ולכן הסקריפט שלהלן רושם ערכים חסרים כריקים ואינו ממיר אותם לאפס. רשימת הנתיבים ושמות הפרמטרים מופיעה במדריך IG API.

הבדיקה מועילה במיוחד לתנאים שאפשר לנסח במפורש: הפרופיל צריך להיות ציבורי, מספר העוקבים צריך להיות בטווח שנקבע, וסימון האימות צריך להתאים לדרישת הבריף. אפשר לשמור את הביוגרפיה לעיון מאוחר יותר, אך השוואה אוטומטית של הטקסט למיצוב השיווקי דורשת קריטריון נפרד.

הכינו את קובץ הקלט

צרו קובץ profiles.csv בקידוד UTF-8. הגרסה המינימלית כוללת username בלבד; השאירו את השדות הצפויים הנוספים ריקים אם אין בבריף מגבלה מתאימה:

username,min_followers,max_followers,verified
brand_example,5000,50000,false
creator_example,10000,,true

הערכים min_followers ו-max_followers מגדירים את גבולות הבדיקה. השדה verified מקבל true או false. אפשר לציין רק את התנאים הרלוונטיים לכל פרופיל.

אחזרו את הנתונים וצרו דוח

התקינו את requests והגדירו את המפתח בסביבת התהליך, ולא בקובץ המקור. ב-macOS או Linux, הפקודות נראות כך:

מאמר: בדיקת פרופילי IG לפני קמפיין פרסום: דוח אי־התאמות ב-Python
תקציר: אם הבריף כולל שמות חשבונות שגויים, רווחים מיותרים או פרופיל לא מתאים, הצוות עלול לגלות זאת רק לאחר הכנת הקמפיין. כך בודקים שמות משתמש ב-IG באמצעות נקודת הקצה המתועדת של jsonscraper ומייצאים ל-CSV את אי־ההתאמות שנצפו.
תפקיד התמונה: איור תומך 2 — היבט ספציפי אחר
מקטע: אחזרו את הנתונים וצרו דו
התרשים מציג את הדרך מ-CSV עם רשימת חשבונות לדוח, שבו שדות חסרים נשארים ריקים והתאמות לכללים מסומנות בנפרד.© jsonscraper · איור שנוצר באמצעות AI
python -m pip install requests
export JSONSCRAPER_INSTAGRAM_LICENSE_KEY='המפתח-שלכם'

שמרו את הסקריפט שלהלן בשם check_profiles.py. הוא משתמש ב-Python 3.8 ומעלה, בודק את סטטוס התשובה החיצונית, קורא בנפרד את המטען ig ויוצר את profile_check.csv. המפתח מועבר כפרמטר query בשם license_key, כפי שמצוין בתיעוד השירות.

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


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"עובדו שורות: {len(output)}; דוח: profile_check.csv")

איך לקרוא את שורות אי־ההתאמה

הפעילו python check_profiles.py. בעמודה status, הערך ok מציין שהסקריפט קיבל את אובייקט הפרופיל הצפוי והצליח ליצור רשומה. העמודה issues כוללת רק כללים שנבדקו, למשל private_profile או below_min_followers. עמודה ריקה פירושה שהתנאים הרשומים לא העלו אי־התאמה; היא אינה מאשרת את איכות התוכן או את העמידה בסעיפים אחרים בחוזה.

השוו את returned_username ל-username המקורי, והעבירו את biography ואת full_name לאחראי לבדיקה סמנטית. הדוח כולל גם שגיאות בקשה, סטטוס API בלתי צפוי והיעדר אובייקט ig: שורות כאלה נשארות בתוצאות ומסייעות להבדיל בין תקלה טכנית לתוצאת הבדיקה.

איך להריץ את הבדיקה באופן קבוע

לבדיקה חד־פעמית, מספיק להפעיל את הסקריפט ידנית. בתהליך מחזורי הוסיפו אותו למתזמן או לתהליך CI: טענו את הרשימה המעודכנת, הריצו את הבקשות, שמרו את ה-CSV כארטיפקט והודיעו לצוות אם מופיעים ערכים בעמודה issues. אל תדפיסו את המפתח ליומנים; שמרו אותו כסוד בסביבת הריצה.

אם אתם בודקים אותם פרופילים לעיתים קרובות, אפשר להעביר את הפרמטר cache_timeout כמספר שניות לשמירה במטמון. לפי התיעוד, שמירה במטמון עבור IG כבויה כברירת מחדל; ערך גדול מאפס מפעיל אותה למשך התקופה שצוינה. כדאי להוסיף את הפרמטר רק אם מותר להשתמש מחדש בתשובה במהלך פרק הזמן שנבחר.

בדקו רק נתונים ותרחישים שאתם מורשים לבדוק. השתמשו בתוצאה כתמונת מצב של תשובת API מסוימת, תעדו את מועד ההרצה ביומן שלכם ועדכנו את הספים בהתאם לבריף. פרטים על הנתיב, השדות הזמינים ואפשרויות האינטגרציה מופיעים בעמוד IG Scraper API ובתיעוד הרשמי של נקודת הקצה.

אֲנָשִׁים

עדיין לא רשומים אנשים עבור מאמר זה.

המשיכו לקרואאיך לבדוק לידים מטיקטוק באינסטגרם לפני העברתם ל-CRM
קרא את המאמר הבא

הפכו את מה שקראתם לאינטגרציה עובדת

גלו את ממשקי ה-API לנתונים חברתיים של jsonscraper, בדקו בקשות ובנו את תהליך העבודה הבא.

גלה API