# التحقق من ملفات Instagram قبل الحملة الإعلانية: تقرير بالفروقات باستخدام Python

https://jsonscraper.com/ar/blog/instagram-profile-campaign-validation-report

Author: Michael Johnson

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

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

استخرج المعلومات العامة عن الحسابات الواردة في الموجز، وأنشئ جدولًا بالاستثناءات قبل إطلاق الحملة

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

 

## ما النتيجة التي ستحصل عليها

 

يُدخل البرنامج ملف CSV يضم قائمة الحسابات والقيم المتوقعة الاختيارية. وينتج صفًا مستقلًا لكل اسم مستخدم تتم معالجته، يتضمن حالة الطلب واسم الملف الشخصي وعلامة التحقق وعدد المتابعين والمنشورات والحسابات التي يتابعها، فضلًا عن قائمة موجزة بالفروقات المكتشفة.



![المقال: التحقق من ملفات Instagram قبل الحملة الإعلانية: تقرير بالفروقات باستخدام Python
الملخص: إذا تضمن الموجز أسماء حسابات خاطئة أو مسافات زائدة أو ملفًا شخصيًا غير مناسب، فقد لا يكتشف الفريق ذلك إلا بعد إعداد الحملة. نوضح كيفية التحقق من أسماء مستخدمي Instagram عبر نقطة النهاية الموثقة في jsonscraper، وتصدير الفروقات المرصودة إلى ملف CSV.
دور الصورة: غلاف — الفكرة الأساسية
القسم: ما النتيجة التي ستحصل عليها
الموضوع المرئي: صورة تحريرية «](https://jsonscraper.com/assets/uploads/journal/2026/11/84aacded9a89d423a6289b53b549643f.png.hero.webp)

يجمع التقرير حقول الملف الشخصي التي جرى التحقق منها وملاحظات للمراجعة اليدوية قبل إطلاق الحملة.© jsonscraper · أُنشئت باستخدام الذكاء الاصطناعي

 

يفيد هذا التقرير المسوّق الذي يطابق بيانات المتعاقدين مع الموجز، والمطوّر الذي ينشئ فحصًا داخليًا ضمن مهمة دورية. وهو يتحقق من حقول محددة في الملف الشخصي العام وقت الطلب؛ أما الحكم اليدوي على مدى ملاءمة الحساب للحملة فيبقى من مسؤولية الفريق.

 

## ما الحقول التي يمكن التحقق منها

 

تقبل نقطة النهاية الموثقة في 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,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 — جانب محدد مختلف
القسم: طلب البيانات وإنشاء التقرير
الموضوع المرئي: مخطط يوضح المسار من قائمة الحسابات في CSV إلى التقرير الذي تبقى فيه الحقول الفارغة فارغة، وتُعلّم فيه المطابقات للقواعد على نحو منفصل](https://jsonscraper.com/assets/uploads/journal/2026/11/146a636928d29c035050cacd0aa101b8.png.hero.webp)

يوضح المخطط المسار من ملف CSV الذي يضم قائمة الحسابات إلى التقرير، مع إبقاء الحقول الفارغة كما هي وتمييز حالات مطابقة القواعد على حدة.© jsonscraper · رسم توضيحي مُنشأ بالذكاء الاصطناعي

 

```
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` لتحديد مدة التخزين المؤقت بالثواني. وتذكر الوثائق أن التخزين المؤقت في Instagram معطل افتراضيًا؛ وتفعيله ممكن بإسناد قيمة أكبر من صفر إليه، فيظل فعالًا طوال المدة المحددة. لا تضف هذا المعامل إلا إذا كان من المقبول إعادة استخدام الاستجابة خلال الفترة المختارة.

 

لا تتحقق إلا من البيانات والسيناريوهات التي يحق لك استخدامها. تعامل مع النتيجة على أنها لقطة لاستجابة API محددة، وسجّل تاريخ التشغيل في سجلّك الخاص، وراجع الحدود بالتزامن مع الموجز. لمزيد من التفاصيل حول نقطة النهاية والحقول المتاحة وخيارات التكامل، راجع صفحة [Instagram Scraper API](https://jsonscraper.com/services/ig-scraper-api) و[الوثائق الرسمية لنقطة النهاية](https://github.com/jsonscraper/instagram-api-python/blob/main/docs/endpoints.md).
