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

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

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 ובתיעוד הרשמי של נקודת הקצה.