يساعد التحقق من حسابات IG قبل إطلاق الحملة على اكتشاف الأخطاء في قائمة مواضع الإعلان ما دام إصلاحها سهلًا. فقد يتضمن الموجز خطأً مطبعيًا في اسم مستخدم، أو حسابًا مكررًا، أو ملفًا شخصيًا بعدد متابعين غير متوقع. فيما يلي برنامج Python صغير يطلب بيانات عامة لكل اسم مستخدم، ويقارن الاستجابة بشروطك، ويحفظ الصفوف التي يمكن التحقق منها في ملف CSV.
ما النتيجة التي ستحصل عليها
يُدخل البرنامج ملف CSV يضم قائمة الحسابات والقيم المتوقعة الاختيارية. وينتج صفًا مستقلًا لكل اسم مستخدم تتم معالجته، يتضمن حالة الطلب واسم الملف الشخصي وعلامة التحقق وعدد المتابعين والمنشورات والحسابات التي يتابعها، فضلًا عن قائمة موجزة بالفروقات المكتشفة.

يفيد هذا التقرير المسوّق الذي يطابق بيانات المتعاقدين مع الموجز، والمطوّر الذي ينشئ فحصًا داخليًا ضمن مهمة دورية. وهو يتحقق من حقول محددة في الملف الشخصي العام وقت الطلب؛ أما الحكم اليدوي على مدى ملاءمة الحساب للحملة فيبقى من مسؤولية الفريق.
ما الحقول التي يمكن التحقق منها
تقبل نقطة النهاية الموثقة في 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,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 أو أحدث، ويتحقق من حالة استجابة HTTP، ويقرأ حمولة البيانات ig على نحو منفصل، ثم ينشئ الملف profile_check.csv. يُمرر المفتاح باعتباره معامل استعلام 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. وتعني القيمة ok في العمود status أن البرنامج استلم كائن الملف الشخصي المتوقع وتمكن من إنشاء سجل. أما العمود issues فيتضمن القواعد التي جرى التحقق منها فقط، مثل private_profile أو below_min_followers. ويعني خلو العمود من القيم أن الشروط المسجلة لم تكشف فروقات؛ لكنه لا يؤكد جودة المحتوى أو توافقه مع بنود أخرى في العقد.
طابق returned_username مع اسم المستخدم الأصلي، وأحِل biography وfull_name إلى الموظف المسؤول للتحقق من دلالتهما. ويتضمن التقرير أيضًا أخطاء الطلب، وحالة API غير المتوقعة، وغياب الكائن ig؛ فتبقى هذه الصفوف ضمن النتائج لتساعد على التمييز بين العطل التقني ونتيجة التحقق.
تشغيل التحقق بانتظام
يكفي تشغيل البرنامج يدويًا لإجراء تحقق لمرة واحدة. أما في العمليات الدورية، فأضِفه إلى مجدول المهام أو سير عمل CI: حمّل القائمة المحدّثة، ونفّذ الطلبات، واحفظ ملف CSV بوصفه مخرجًا، وأخطر الفريق إذا ظهرت قيم في العمود issues. لا تطبع المفتاح في السجلات؛ واحفظه سرًا ضمن بيئة التشغيل.
إذا كنت تتحقق من الملفات الشخصية نفسها كثيرًا، فيمكن تمرير المعامل cache_timeout لتحديد مدة التخزين المؤقت بالثواني. وتذكر الوثائق أن التخزين المؤقت في IG معطل افتراضيًا؛ وتفعيله ممكن بإسناد قيمة أكبر من صفر إليه، فيظل فعالًا طوال المدة المحددة. لا تضف هذا المعامل إلا إذا كان من المقبول إعادة استخدام الاستجابة خلال الفترة المختارة.
لا تتحقق إلا من البيانات والسيناريوهات التي يحق لك استخدامها. تعامل مع النتيجة على أنها لقطة لاستجابة API محددة، وسجّل تاريخ التشغيل في سجلّك الخاص، وراجع الحدود بالتزامن مع الموجز. لمزيد من التفاصيل حول نقطة النهاية والحقول المتاحة وخيارات التكامل، راجع صفحة IG Scraper API والوثائق الرسمية لنقطة النهاية.