نظرة عامة
تصف استجابة API مشاهدات ضمن نطاق وتجميع وتاريخ جمع محدد. وهي ليست قائمة بكل الروابط على الويب. يستخدم هذا الدليل المستورد المحلي ومثال shop.example الافتراضي. اختُبر المستورد دون اتصال؛ ولم يُنفذ طلب مدفوع أو قياس لتغطية فهرس المزود.
اختر الهدف واحتفظ بالطلب
تدعم نقطة backlinks/backlinks/live في DataForSEO النطاقات والنطاقات الفرعية والصفحات. تحقق من الصيغة الحالية في الوثائق واختر النطاق المناسب لسؤالك. لا تصف طلب صفحة واحدة بأنه تقرير كامل للنطاق. احتفظ بالمعلمات المرسلة مع الاستجابة الأصلية لتمكين المراجعة.
يغير التجميع معنى الصف. تشمل الأوضاع الموثقة as_is وone_per_domain وone_per_anchor. لا تعامل التقارير المجمعة بطرق مختلفة على أنها قابلة للمقارنة مباشرة. تصف الوثائق روابط فريدة لكل صفحة مُحيلة وحقل links_count للتكرار. لا يمثل الصف بالضرورة كل عنصر رابط HTML في الصفحة؛ وتعريف المزود أهم من تسمية مريحة في جدول.
خطط للوصول والتكاليف قبل الجمع
تُحاسب الطلبات إلى النقطة المباشرة. احصل على الإذن، وتحقق من الأسعار الحالية، وضع سقفاً صارماً للإنفاق، واحتفظ بالاستجابات المفيدة في ذاكرة مؤقتة. تحديد عدد الصفوف وحده لا يكفي إذا كانت المهمة تستطيع إرسال طلبات كثيرة. احتفظ ببيانات الاعتماد على الخادم وتجنب نسخها في صور الشاشة أو الصادرات المشتركة أو الأدوات العامة في المتصفح.
يعالج هذا التمرين استجابة مقدمة محلياً ولا يتطلب بيانات حساب. لا يتحقق من تسجيل الدخول أو التوفر المباشر أو صلاحيات الحساب أو اكتمال الفهرس. عند جمع استجابة حقيقية، سجل التاريخ والهدف والفلاتر والتجميع وإعدادات الصفحات واحتفظ بالملف الأصلي بصورة خاصة.
افحص الحالة والنطاق قبل الصفوف
تحقق من بنية الاستجابة العامة وحالة كل مهمة. خطأ المصادقة أو المهمة ليس دليلاً على أن الهدف يملك صفراً من الروابط. يرفض المستورد الاستجابات الفاشلة أو غير المدعومة بدلاً من إنشاء تقرير نجاح فارغ. حدد السبب وصححه أولاً.
قارن الإجمالي بعدد العناصر المعادة. يحتوي المثال الافتراضي على إجمالي 9 ويعيد أربعة سجلات، لذلك توصف النتيجة صراحة بأنها جزئية. هذه أرقام توضيحية وليست إحصاءات موقع حقيقي. لا يعني الفرق وجود خمسة روابط مفقودة أو معطلة. يتطلب الاسترجاع الإضافي خطة مسموحاً بها ومحدودة وبإعدادات متسقة.
أعد تنفيذ المثال المحلي
استخدم المثال المقدم أو ملف JSON القابل للتنزيل. تحقق من الهدف shop.example والوضع as_is وأربعة سجلات وإشارة النتيجة الجزئية. قارن تفاصيل الصفوف بملف JSON الأصلي قبل تنزيل إسقاط CSV. توجد أيضاً نسخة JavaScript قابلة للتنزيل تعمل دون اتصال. احتفظ بالاستجابة الخام منفصلة لأن CSV لا يحفظ كل حقول المزود.
تبقى القيم الناقصة مجهولة ولا تتحول إلى صفر أو false. النص الرابط الغائب يختلف عن النص الفارغ، وحقل dofollow لدى المزود منفصل عن قائمة السمات. يتضمن صف sponsored وnofollow، وصف آخر ملاحظة فقد، وآخر حقولاً ناقصة. تساعد هذه الحالات على اكتشاف تغير المعنى بصمت في الجداول والتقارير اللاحقة.
تحقق من المخرجات وسجل الحدود
اجتازت مجموعة اختبارات المستورد المحددة 21 اختباراً في 28 أكتوبر 2026. تشمل أمثلة اللغات والاستجابات الفاشلة وحدود الحجم والعدد والحفاظ على المجهول والعناوين غير الصحيحة والتصدير دون اتصال. يثبت ذلك الحالات المختبرة للمستورد، ولا يقيس تغطية المزود أو حداثته أو دقته.
افصل تاريخ أول وآخر مشاهدة عن تاريخ إنشاء الرابط أو إزالته فعلياً. لا تثبت علامة الفقد الإزالة الدائمة، وقد تكون حالة HTTP المسجلة قديمة. يمكن لفحص مستقل ومسموح لصفحة المصدر دراسة الوضع الحالي. سجل تواريخ مشاهدات المزود وفحوصك واستنتاجاتك بصورة منفصلة. لا تستنتج الترتيب أو الزيارات من عدد الروابط وحده.