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

https://jsonscraper.com/he/blog/check-instagram-profiles-before-campaign-2

Author: Michael Johnson

Published: 2026-11-19T11:38:12+00:00

Updated: 2026-11-19T11:38:12+00:00

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

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

 

## מה יתקבל

 

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



![מאמר: בדיקת פרופילי Instagram לפני קמפיין פרסום: דוח אי־התאמות ב-Python
תקציר: אם הבריף כולל שמות חשבונות שגויים, רווחים מיותרים או פרופיל לא מתאים, הצוות עלול לגלות זאת רק לאחר הכנת הקמפיין. כך בודקים שמות משתמש ב-Instagram באמצעות נקודת הקצה המתועדת של jsonscraper ומייצאים ל-CSV את אי־ההתאמות שנצפו.
תפקיד התמונה: תמונת שער — הרעיון המרכזי
מקטע: מה יתקבל
נושא חזותי: צילום מערכת מערכת טעינה](https://jsonscraper.com/assets/uploads/journal/2026/11/84aacded9a89d423a6289b53b549643f.png.hero.webp)

הדוח מרכז את שדות הפרופיל שנבדקו ואת ההערות לבדיקה ידנית לפני השקת הקמפיין.© jsonscraper · נוצר באמצעות AI

 

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

 

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

 

הנתיב המתועד של Instagram API‏ `/v1/user/by/username` מקבל את הפרמטר החובה `username`. במבנה התשובה שנצפה, נתוני הפרופיל נמצאים באובייקט `ig`; השדות שהוחזרו כללו את `username`, `full_name`, `is_private`, `is_verified`, `media_count`, `follower_count`, `following_count` ו-`biography`. השדות עשויים שלא להופיע תמיד, ולכן הסקריפט שלהלן רושם ערכים חסרים כריקים ואינו ממיר אותם לאפס. רשימת הנתיבים ושמות הפרמטרים מופיעה ב[מדריך Instagram API](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).

 

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

 

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

 

צרו קובץ `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, הפקודות נראות כך:



![מאמר: בדיקת פרופילי Instagram לפני קמפיין פרסום: דוח אי־התאמות ב-Python
תקציר: אם הבריף כולל שמות חשבונות שגויים, רווחים מיותרים או פרופיל לא מתאים, הצוות עלול לגלות זאת רק לאחר הכנת הקמפיין. כך בודקים שמות משתמש ב-Instagram באמצעות נקודת הקצה המתועדת של jsonscraper ומייצאים ל-CSV את אי־ההתאמות שנצפו.
תפקיד התמונה: איור תומך 2 — היבט ספציפי אחר
מקטע: אחזרו את הנתונים וצרו דו](https://jsonscraper.com/assets/uploads/journal/2026/11/146a636928d29c035050cacd0aa101b8.png.hero.webp)

התרשים מציג את הדרך מ-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` כמספר שניות לשמירה במטמון. לפי התיעוד, שמירה במטמון עבור Instagram כבויה כברירת מחדל; ערך גדול מאפס מפעיל אותה למשך התקופה שצוינה. כדאי להוסיף את הפרמטר רק אם מותר להשתמש מחדש בתשובה במהלך פרק הזמן שנבחר.

 

בדקו רק נתונים ותרחישים שאתם מורשים לבדוק. השתמשו בתוצאה כתמונת מצב של תשובת API מסוימת, תעדו את מועד ההרצה ביומן שלכם ועדכנו את הספים בהתאם לבריף. פרטים על הנתיב, השדות הזמינים ואפשרויות האינטגרציה מופיעים בעמוד [Instagram Scraper API](https://jsonscraper.com/services/ig-scraper-api) וב[תיעוד הרשמי של נקודת הקצה](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).
