يمكنك استخراج متابعي Instagram باستخدام Python عبر إرسال اسم مستخدم واحد أو أكثر لملفات عامة، أو عناوين URL الخاصة بها، أو معرّفات المستخدم الرقمية إلى Instagram Followers Scraper API من Datablist باستخدام مكتبة Requests. تُرجع API سجلات المتابعين بتنسيق JSON وتحدّد الملف المصدر لكل علاقة.
يبدأ هذا الدليل بالمتابعين الذين جُمعت بياناتهم لحساب Jupiter Hikes، وهو رحّالة لمسافات طويلة وصانع أفلام. بعد ذلك، سأعيد استخدام دالة Python نفسها لمقارنة متابعيه الذين جُمعت بياناتهم بمتابعي Darwin on the Trail، وهو رحّالة آخر لمسافات طويلة وصانع أفلام عن الطبيعة. تجمع الشيفرة النتائج حسب معرّف مستخدم Instagram الرقمي وتحدّد المستخدمين الموجودين في القائمتين.
🔑 ملخص لمن لا يملكون وقتًا
استخدم Instagram Followers Scraper API من Datablist لاستخراج متابعي ملفات Instagram العامة باستخدام Python. أرسل الملفات التي تريد استخراج بياناتها، وحدّد حدًا أقصى لكل ملف، ثم استرجع سجلات المتابعين المتاحة بتنسيق JSON لاستخدامها في أبحاثك أو عملياتك التسويقية. قبل البدء، تحقّق من أن Instagram يتيح لك تصفّح متابعي كل ملف.
- المدخلات: أسماء مستخدمي Instagram أو عناوين URL للملفات أو معرّفات المستخدم الرقمية.
- المخرجات: سجلات المتابعين، بما فيها معرّفات المستخدم وتفاصيل الملف المتاحة والملف المصدر الذي جاء منه كل متابع.
💡 تفضّل حلًا دون كتابة كود؟ استخدم Instagram Followers source من Datablist لإنشاء صفوف المتابعين دون برمجة.
يشرح دليل جمع متابعي Instagram ضمن Collection المصدر نفسه من خلال واجهة Datablist. أما بقية هذا الدليل فتركّز على API.
تحقّق مما إذا كان Instagram يقيّد قائمة المتابعين
قبل إرسال مهمة الاستخراج، افتح ملف Instagram المستهدف وانقر على Followers. تأكّد من قدرتك على تصفّح قائمة المتابعين؛ فكون الملف عامًا لا يعني بالضرورة أن Instagram يعرض جميع متابعيه.
إذا ظهرت لك العبارة “Only [username] can see all followers,” فتوقّع الحصول على قائمة جزئية من أداة الاستخراج، حتى لو كان الملف عامًا. لا تستطيع API استرجاع سوى المتابعين الذين يتيحهم Instagram، ولن تؤدي زيادة الحد المطلوب إلى إظهار المتابعين المخفيين.
تحقّق من كل ملف تنوي استخراج بياناته لتعرف مسبقًا ما إذا كانت قائمة المتابعين المتاحة كافية لمهمتك قبل بدء طلب API.
إعداد Python ومفتاح Datablist API
يتوفر الوصول إلى Datablist REST API ضمن خطة Growth. كما تستهلك مهام Sources أرصدة، وسأوضّح تكلفة مصدر المتابعين بعد الشرح العملي.
أنشئ Personal API Key من صفحة API في حساب Datablist. سنستخدم في هذا المثال حزمة requests. أنشئ مجلدًا للمشروع، وافتحه في Terminal، ثم نفّذ:
python -m venv .venv
source .venv/bin/activate
python -m pip install requestsأنشئ ملفًا باسم scrape_instagram_followers.py، ثم ضع مفتاحك في متغير البيئة DATABLIST_API_KEY:
export DATABLIST_API_KEY="your-api-key"يقرأ السكربت هذا المتغير ويرسل قيمته عبر Header باسم X-API-Key.
استخراج متابعي Instagram بدالة Python واحدة
يستخدم الطلب الأول اسم المستخدم jupiterhikes، العائد للرحّالة وصانع المحتوى Jupiter Hikes. يقبل المصدر أيضًا عنوان URL كاملًا للملف أو معرّف مستخدم Instagram رقميًا. على سبيل المثال، المعرّف الرقمي لـ Jupiter Hikes هو "1507518892".
الصق السكربت الكامل التالي في scrape_instagram_followers.py:
import json
import os
import time
import uuid
import requests
def scrape_instagram_users(
profiles,
api_key,
scraping_type="followers",
limit_per_profile=100,
):
"""Submit profiles, wait for the source task, and return all generated users."""
tasks_url = "https://api.datablist.com/v1/sources/tasks"
headers = {"X-API-Key": api_key}
unique_id = str(uuid.uuid4())
print(f"Task uniqueId: {unique_id}", flush=True)
payload = {
"sourceId": "instagram-source",
"uniqueId": unique_id,
"settings": {
"profiles": profiles,
"scrapingType": scraping_type,
"limitPerProfile": limit_per_profile,
},
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
print(f"Task ID: {task_id}")
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
print(f"Task status: {task['status']}; credits used: {task['credits']['used']}")
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
results = []
params = {"limit": 10}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
results.extend(page["results"])
next_cursor = page["nextCursor"]
if next_cursor is None:
break
params["cursor"] = next_cursor
return results
if __name__ == "__main__":
api_key = os.environ.get("DATABLIST_API_KEY")
if not api_key:
raise RuntimeError("Set DATABLIST_API_KEY before running this script.")
profiles = ["jupiterhikes"]
follower_results = scrape_instagram_users(profiles, api_key)
print(json.dumps(follower_results, indent=2, ensure_ascii=False))شغّله باستخدام:
python scrape_instagram_followers.pyتنفّذ الدالة ثلاثة أنواع من استدعاءات API بالترتيب التالي:
- يرسل
POST /v1/sources/tasksمعرّف المصدر والإعدادات. تقبل API المهمة التي تعمل في الخلفية وتُرجع معرّفها. - يتحقّق
GET /v1/sources/tasks/{taskId}من حالة المهمة كل ثلاث ثوانٍ. ينتظر عميل Requests، بينما تعمل المهمة نفسها بشكل غير متزامن داخل Datablist. - يسترجع
GET /v1/sources/tasks/{taskId}/resultsصفحة من كائنات المتابعين المسطّحة. تعيد الحلقة تمرير كل قيمةnextCursorغير فارغة كما هي حتى تُرجع API القيمةnull.
يضبط المثال scrapingType على followers ويطلب 100 مستخدم عبر limitPerProfile. تعامل مع الرقم 100 باعتباره حدًا مطلوبًا، لا عددًا نهائيًا مضمونًا للنتائج. فقد تؤثر حدود صفحات مزوّد البيانات والمستخدمون المتاحون أثناء تنفيذ المهمة في العدد المُرجع.
يطبع السكربت قيمة uniqueId قبل الإرسال. إذا انقطع الاتصال أثناء طلب POST، فستساعدك هذه القيمة في العثور على المهمة المقبولة بدلًا من إنشاء مهمة مدفوعة أخرى فورًا.
كيف تنشئ API سجلات علاقات المتابعين
تحدّد Datablist أولًا ملف Instagram المصدر لكل اسم مستخدم أو عنوان URL كامل أو معرّف رقمي. بعد ذلك، تسترجع العمليات التي تعمل في الخلفية صفحات المتابعين وتتعامل مع Cursor الخاص بمزوّد البيانات. وما عليك إدارته سوى مهمة Datablist ومؤشرات صفحات النتائج الموضحة في السكربت.
تُزال معرّفات المستخدم المكررة داخل القائمة المُرجعة لملف مصدر واحد. وعندما يظهر المستخدم نفسه لدى اثنين من صنّاع المحتوى المُرسلين، تحتفظ API بسجلين للعلاقة، يحمل كل منهما حقول followerSourceProfile... مختلفة. وهذا السلوك هو ما يتيح مقارنة الجمهورين.
استخدم الحقول التالية في الأقسام اللاحقة:
- يمثّل
instagramUserIdالمفتاح الثابت لمقارنة المستخدمين المُرجعين. - تصف حقول
instagramUsernameوinstagramFullNameوغيرها من حقولinstagram...المتابع عندما تكون هذه البيانات العامة متاحة. - تحدّد حقول
followerSourceProfileIdوfollowerSourceProfileUsernameوfollowerSourceProfileUrlصانع المحتوى الذي بدأت منه العملية.
يسترجع هذا المصدر قوائم العلاقات؛ ولا يبحث عن مرشحين أو يحسب درجات ثقة.
قراءة نتائج Jupiter Hikes
أعادت مهمة Jupiter Hikes المكتملة 124 سجلًا فريدًا للمتابعين واستهلكت 2.24 رصيدًا. ورغم أن الطلب حدّد limitPerProfile: 100، كان العدد الجاري 99 قبل أن يعيد مزوّد البيانات صفحة أخرى تضم 25 مستخدمًا. احتفظت Datablist بالصفحة كاملة، فوصل إجمالي النتائج إلى 124.
فيما يلي استجابة صفحة النتائج النهائية. تم الإبقاء على الغلاف وكائنات المتابعين الأربعة كما أُعيدت:
{
"taskId": "695846750eb440c3870e763d38ef4f4b",
"results": [
{
"instagramUserId": "52256365838",
"instagramUsername": "adventuresoforest",
"instagramFullName": "Forest",
"instagramProfileUrl": "https://www.instagram.com/adventuresoforest/",
"instagramPicture": "https://scontent-fra3-2.cdninstagram.com/v/t51.82787-19/809812326_18068055263741839_8426418313724501534_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=1hyyyEDHulgQ7kNvwFJIKKP&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GGbBRDCPB8fvzDBAAB4eZa7PpvB0bmNDAQAB1501500j-ccb7-5&oh=00_AQQZ3R0wDeV-bTnR2lYSje_IQ-ly9n6pyxGHXpJGAmzUHA&oe=6AF37F89&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "199102398",
"instagramUsername": "richie_nu_field",
"instagramFullName": "新野 豊",
"instagramProfileUrl": "https://www.instagram.com/richie_nu_field/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.2885-19/348434195_2264827180367957_813086592749200065_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42NDAuYzIifQ&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=xux3gQ4SQEAQ7kNvwGj5tEv&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GBOvxBRVQJAr2QsIAMHicrzyqUgLbkULAAAB1501500j-ccb7-5&oh=00_AQRa3Zl_viAM914UM1_kQYrqGwPLfpmVqPwlMltzkNd44Q&oe=6AF3871F&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "43861505420",
"instagramUsername": "shivroam",
"instagramFullName": "Shivam Rana I Mountaineer",
"instagramProfileUrl": "https://www.instagram.com/shivroam/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.82787-19/858921985_18104766389457421_6701325443259882004_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=NMw7vs1oyqQQ7kNvwEYvnsx&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GAEcMjMNkmJpMFJAABTaykn84-9cbmNDAQAB1501500j-ccb7-5&oh=00_AQR5iJXKSUhS5uS8xmmkgeYw-QZ8AbYxVHqIj3guogZgyA&oe=6AF38C8B&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "23413245087",
"instagramUsername": "double24762",
"instagramFullName": "double 佳",
"instagramProfileUrl": "https://www.instagram.com/double24762/",
"instagramPicture": "https://scontent-iad6-1.cdninstagram.com/v/t51.2885-19/573323465_1219825463302212_7278921664109726296_n.png?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xNTAuYzIifQ&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gH2sHBsdmQY1aWiWoZZWA6eZ603UbEQOH0raGAaH9APRHqzVjuOTqB7gW86Vp6E9Xx44csiK9pjfjrqCVl5R1HC&_nc_ohc=kwiilGbw6cUQ7kNvwHe7b38&edm=AAAAAAABAAAA&ccb=7-5&ig_cache_key=YW5vbnltb3VzX3Byb2ZpbGVfcGlj.3-ccb7-5&oh=00_AQT5TH4G4DvUg9YUXYlVAW4_1Z03ebdjvl84MLuV0umlaQ&oe=6AF37C2A&_nc_sid=328259",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
}
],
"nextCursor": null
}يحمل السجل الأول معرّف المستخدم الرقمي 52256365838 واسم المستخدم adventuresoforest وحقول الملف العام المتاحة. وبما أن قيمة followerSourceProfileUsername هي jupiterhikes، يمكنك معرفة الملف المُرسل الذي أنشأ هذه العلاقة. ويمكن أن تكتمل المهمة حتى عند غياب قيمة اختيارية من الملف. اقرأ الحقول الموجودة بدلًا من محاولة بناء كل سجل وفق Schema ثابت.
مقارنة جمهورين باستخدام معرّف مستخدم Instagram
بعد نجاح الطلب الخاص بملف واحد، أعد استخدام scrape_instagram_users() مع صانعي محتوى الرحلات كليهما ضمن مهمة واحدة. اجمع العلاقات المُرجعة حسب معرّف المستخدم الرقمي، واحتفظ بجميع أسماء المستخدمين المصدرية المرتبطة بكل معرّف:
comparison_profiles = [
"jupiterhikes",
"https://www.instagram.com/darwin_onthetrail/",
]
comparison_results = scrape_instagram_users(comparison_profiles, api_key)
audience_by_id = {}
collected_count = {}
for result in comparison_results:
source_username = result["followerSourceProfileUsername"]
collected_count[source_username] = collected_count.get(source_username, 0) + 1
user_id = result["instagramUserId"]
grouped_user = audience_by_id.setdefault(
user_id,
{"user": result, "source_profiles": set()},
)
grouped_user["source_profiles"].add(source_username)
overlap = [
{
**grouped_user["user"],
"source_profiles": sorted(grouped_user["source_profiles"]),
}
for grouped_user in audience_by_id.values()
if len(grouped_user["source_profiles"]) == len(comparison_profiles)
]
overlap_report = {
"collected_count": collected_count,
"overlap_count": len(overlap),
"overlap": overlap,
}
print(json.dumps(overlap_report, indent=2, ensure_ascii=False))أعادت مهمة الملفين 124 علاقة متابعة لـ Jupiter Hikes و46 لـ Darwin on the Trail. وظهرت ثلاثة معرّفات رقمية في القائمتين اللتين جُمعتا. استهلكت المهمة 2.7 رصيدًا.
تستخدم شيفرة التجميع instagramUserId بدلًا من اسم المستخدم، لأن المعرّف هو مفتاح الربط الثابت الذي تُرجعه API. وتحتفظ بكائن مستخدم كامل واحد من API، ثم تضيف قائمة source_profiles مرتبة. ولكل واحد من المعرّفات المشتركة الثلاثة، تتضمن هذه القائمة darwin_onthetrail وjupiterhikes.
على سبيل المثال، يظهر المعرّف الرقمي 42048393083 مرة في نتائج Jupiter Hikes ومرة في نتائج Darwin on the Trail. يصف السجلان اسم المستخدم hikingful، لكن يحمل كل منهما قيمة followerSourceProfileUsername مختلفة. تدمج شيفرة التجميع سجلي العلاقة في كائن مستخدم واحد يحمل source_profiles: ["darwin_onthetrail", "jupiterhikes"].
📘 فسّر التداخل ضمن نطاقه المحدود: يعني المعرّف المشترك أنه ظهر في الجزأين المُرجعين من القائمتين. ولا يقيس ذلك التداخل الكامل بين جمهوري صانعي المحتوى، ولا يثبت استمرار المتابعة وقت نشر المقال، ولا يؤهل الحساب للتواصل التسويقي.
توضّح قيم collected_count المقام المستخدم في الحساب. وإذا حسبت نسبة مئوية، فسمّها بوضوح. على سبيل المثال، تصف 3 / 124 المعرّفات المشتركة كنسبة من سجلات Jupiter Hikes التي جُمعت في هذه المهمة.
إذا كنت تفضّل سكربتًا محليًا يعمل عبر المتصفح، فراجع دليل استخراج متابعي Instagram وقوائم Following ومؤلفي المنشورات مجانًا.
إثراء الملفات المشتركة لأبحاث الجمهور
يمنحك التداخل معرّفات Instagram الرقمية ومصدر كل علاقة. والخطوة العملية التالية هي إرسال هذه المعرّفات المشتركة إلى Enrichment باسم Instagram Profile Scraper، ثم تقسيم النتائج الناجحة حسب الموقع الإلكتروني أو البريد الإلكتروني العام أو النبذة أو الفئة أو مؤشرات الملف المتاحة.
أضف الدالة الثانية التالية أسفل دالة المصدر. تستخدم الدالة مفتاح API نفسه وتسلسل الإرسال والاستعلام الدوري وتقسيم النتائج إلى صفحات نفسه:
def enrich_instagram_profiles(overlap_users, api_key):
"""Retrieve public profile details for the numeric IDs in the overlap."""
if not overlap_users:
return []
tasks_url = "https://api.datablist.com/v1/enrichments/tasks"
headers = {"X-API-Key": api_key}
inputs = [
{
"inputId": user["instagramUserId"],
"data": {"instagramIdentifier": user["instagramUserId"]},
}
for user in overlap_users
]
payload = {
"enrichmentId": "instagram-profile-scraper",
"uniqueId": str(uuid.uuid4()),
"settings": {"scrapeType": "profile"},
"inputs": inputs,
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
profile_results = []
params = {"limit": 100}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
profile_results.extend(page["results"])
if page["nextCursor"] is None:
break
params["cursor"] = page["nextCursor"]
return profile_results
profile_results = enrich_instagram_profiles(overlap, api_key)
profiles_with_websites = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramWebsite")
]
profiles_with_public_email = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramEmail")
]عندما لا تحتوي القائمتان على معرّفات مشتركة، تكون overlap فارغة وتُرجع الدالة [] قبل إرسال طلب POST. وهكذا يمكنك متابعة العمل بقسم بحثي فارغ دون إنشاء مهمة Enrichment مدفوعة.
يؤدي استخدام كل معرّف رقمي بوصفه inputId وinstagramIdentifier معًا إلى جعل ربط النتائج بالتداخل واضحًا تمامًا. احتفظ بكل كائن نتيجة مُرجع، بما في ذلك حالات الإخفاق والمخرجات الفارغة واستهلاك الرصيد والأخطاء. ولا تطبّق الفلترة إلا عند إنشاء Segment محلي.
يبدأ وضع profile من رصيدين لكل معرّف رقمي، ويمكنه إرجاع النبذة العامة والموقع الإلكتروني والبريد الإلكتروني أو رقم الهاتف عندما يعرضها الملف، إلى جانب أعداد الملف وتفاصيل الفئة. وقد تكون حقول الاتصال فارغة حتى عند العثور على الملف. تُعد الشيفرة Segments البحث محليًا؛ ولا ترسل رسائل ولا تعتبر المتابع المشترك موافقًا على التواصل معه.
لإنجاز هذه الخطوة دون كود، استخدم Instagram Profile Scraper من Datablist.
التبديل من المتابعين إلى حسابات Following
يمكن للمصدر نفسه استرجاع الحسابات التي يتابعها ملف مُرسل. غيّر وسيطة scraping_type فقط:
following_results = scrape_instagram_users(
["1507518892"],
api_key,
scraping_type="following",
limit_per_profile=100,
)تصف هذه السجلات الحسابات التي يتابعها Jupiter Hikes. وتنتقل بيانات المصدر إلى followingSourceProfileId وfollowingSourceProfileUsername وfollowingSourceProfileUrl. استخدم العدد الفعلي المُرجع كما تفعل في وضع المتابعين.
تقدير تكلفة Instagram Followers API
يستهلك مصدر متابعي Instagram مقدار 0.01 رصيد لكل مستخدم مُرجع، سواء كان متابعًا أو حسابًا ضمن Following. وقد يستهلك تحديد الملف المصدر المُرسل ما يصل إلى رصيد إضافي واحد. ويمكن أن يقلّل استخدام البيانات المخزنة مؤقتًا التكلفة الفعلية.
بالنسبة إلى ملفين وحد مطلوب قدره 100 مستخدم لكل ملف، يكون التقدير المبدئي:
2 × (1 + 100 × 0.01) = 4 credits
هذا تقدير وليس حدًا أقصى. فقد أعادت مهمة الملفين 170 سجل علاقة واستهلكت 2.7 رصيدًا. اقرأ task.credits.used بعد التنفيذ لمعرفة التكلفة الفعلية.
الوصول إلى API والأرصدة المتضمنة في الخطة وعمليات Top-up الاختيارية واستخدام المهام بنود منفصلة. تبلغ تكلفة خطة Growth الشهرية 50 دولارًا أو 50 يورو، وتشمل الوصول إلى REST API و20,000 رصيد شهريًا. وتضيف أصغر باقة Top-up متاحة حاليًا 20,000 رصيد مقابل 20 دولارًا أو 17.50 يورو.
وفق أسعار Top-up هذه، يستهلك 1,000 مستخدم مُرجع 10 أرصدة. وتعادل هذه الكمية 0.01 دولار أو 0.00875 يورو قبل تحديد الملف المصدر. وهذه قيمة استخدام معيارية وليست باقة يمكن شراؤها؛ إذ تظل تكلفة Top-up مقدارها 20 دولارًا أو 17.50 يورو، ولا يزال الوصول إلى API يتطلب اشتراك Growth. راجع أسعار Datablist الحالية للاطلاع على التفاصيل.
لـ Instagram Profile Scraper الاختياري تكلفة مستقلة. عند استخدام معرّف رقمي وscrapeType: "profile"، تبدأ التكلفة من رصيدين لكل ملف متداخل مُرسل.
حل مشكلات المدخلات والمهام والنتائج الشائعة
مفتاح API مفقود
يعرض السكربت الخطأ Set DATABLIST_API_KEY before running this script. قبل إرسال أي طلب HTTP. صدّر المتغير في جلسة Shell نفسها، ثم شغّل الملف مجددًا.
API ترفض المفتاح
تُطلق response.raise_for_status() خطأ HTTP. تحقّق من نسخ Personal API Key بصورة صحيحة ومن أن حسابك يتيح الوصول إلى API ضمن خطة Growth. احتفظ بـ Header الوحيد X-API-Key المستخدم في المثال.
تعذّر تحديد الملف المصدر
تأكّد من أن كل قيمة هي اسم مستخدم أو عنوان URL كاملًا لملف Instagram أو معرّف مستخدم رقميًا على هيئة String. افحص المهمة الحالية والخطأ المسجل فيها قبل إنشاء مهمة مدفوعة أخرى.
الرصيد غير كافٍ
تحقّق من رصيدك وقلّل عدد الملفات أو الحد المطلوب قبل إرسال مهمة أخرى. وقد تكون المهمة التي بدأت بالفعل قد استهلكت جزءًا من الرصيد.
فشلت المهمة أو توقفت
يطبع السكربت معرّف المهمة ويُطلق RuntimeError. استخدم المعرّف لفحص المهمة الحالية وقيمة error وcredits.used وأي نتائج جزئية متاحة. قد تحتفظ المهمة الفاشلة أو المتوقفة بالصفوف التي أنشأتها، لذا افحصها قبل إعادة الإرسال.
العدد المُرجع يختلف عن الحد المطلوب
اعتمد العدد الفعلي الموجود في النتائج. يمثّل limitPerProfile حدًا مطلوبًا، ولا يضمن عددًا دقيقًا. كما أن نتيجة واحدة لا توضّح سبب إرجاع مزوّد البيانات عددًا أقل أو أكثر من المستخدمين المتاحين.
فُقدت استجابة إرسال المهمة
اعرض مهام المصدر الأخيرة وطابق قيمة uniqueId التي طُبعت قبل طلب POST:
unique_id = "paste-the-printed-unique-id"
response = requests.get(
"https://api.datablist.com/v1/sources/tasks",
headers={"X-API-Key": api_key},
params={"sourceId": "instagram-source", "limit": 100},
)
response.raise_for_status()
for task in response.json()["tasks"]:
if task["uniqueId"] == unique_id:
print(task["@id"], task["status"])تابع الاستعلام الدوري عن معرّف المهمة ذاك أو استرجع نتائجها الحالية. تشرح وثائق مهام Sources بالتفصيل Endpoints الخاصة بالقائمة والحالة والنتائج والاحتفاظ بالبيانات.
الخطوات التالية
أصبحت لديك الآن دالة Python Requests قابلة لإعادة الاستخدام تسترجع علاقات متابعي Instagram، إلى جانب تقرير محلي يقارن قائمتي Jupiter Hikes وDarwin on the Trail المجمّعتين حسب معرّف المستخدم الرقمي. ويحتفظ كل سجل مشترك بالملفين المصدرين.
استبدل الأمثلة بمجموعة صغيرة ومدروسة من الملفات العامة لصنّاع المحتوى. اختر حدًا مقصودًا لكل ملف، ثم فسّر التداخل في ضوء العدد الفعلي المُرجع لكل مصدر. يمكنك تنزيل مثال Requests المتزامن والمحافظ عليه، أو استخدام مثال HTTPX غير المتزامن والمحافظ عليه عندما تحتاج إلى تنفيذ متزامن غير حاجب. وإذا كنت تحتاج أولًا إلى حسابات مصدرية، فابدأ بدليل العثور على ملفات Instagram باستخدام الكلمات المفتاحية.



