Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

تقاطع الصفحات

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO العمليات

تقاطع الصفحات

​

الصفحات التي تربط بعدة عناوين URL هدف دفعة واحدة، بدلًا من النطاقات. ⚠️ targets كائن مفهرس حسب الموضع ويأخذ عناوين URL كاملة، لا نطاقات مجرّدة. يحمل كل صف page_intersection وsummary لكل هدف. المكافئ على مستوى النطاق هو post_dataforseo_backlinks_domain_intersection_live، وهو الأول الذي ينبغي اللجوء إليه.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.033 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
application/json
  • النوع: array (object | null)[]
    • backlinks_status_type
      النوع: string | null

      تحديد الروابط الخلفية التي ستُعاد وتُحتسب
      حقل اختياري
      يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة لـtargets؛
      القيم الممكنة:
      all — تُعاد جميع الروابط الخلفية وتُحتسب؛
      live — تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛
      lost — تُعاد الروابط الخلفية المفقودة وتُحتسب؛

      القيمة الافتراضية: live

    • exclude_internal_backlinks
      النوع: boolean | null

      يشير إلى ما إذا كانت الروابط الخلفية الداخلية من النطاقات الفرعية إلى target ستُستبعد من النتائج
      حقل اختياري
      إذا ضُبط على true، فلن تتضمن النتائج بيانات عن الروابط الخلفية الداخلية من النطاقات الفرعية للنطاق نفسه الخاص بـtarget
      إذا ضُبط على false، فستُضمَّن الروابط الداخلية في النتيجة
      القيمة الافتراضية: true

    • exclude_targets
      النوع: array string[] | null

      النطاقات أو النطاقات الفرعية أو صفحات الويب التي تريد استبعادها
      حقل اختياري
      يمكنك تعيين ما يصل إلى 10 نطاقات أو نطاقات فرعية أو صفحات ويب
      إذا استخدمت هذه المصفوفة، فستتضمن النتائج الصفحات المُحيلة التي تربط بـtargets ولكنها لا تربط بـexclude_targets
      مثال:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"]

    • filters
      النوع: array (object | null)[] | null

      مصفوفة معاملات تصفية النتائج
      حقل اختياري
      يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
      يجب تعيين معامل منطقي and أو or بين الشروط
      المعاملات المدعومة:
      regex، not_regex، =، <>، in، not_in، like، not_like، ilike، not_ilike، match، not_match
      يمكنك استخدام المعامل % مع like وnot_like لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
      مثال:
      ["1.rank",">","80"]

      [["2.page_from_rank",">","55"],
      "and",
      ["1.original","=","true"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]

      القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.

      كائن فارغ
    • include_indirect_links
      النوع: boolean | null

      يشير إلى ما إذا كانت الروابط غير المباشرة إلى targets ستُضمَّن في النتائج
      حقل اختياري
      إذا ضُبط على true، فستتضمن النتائج بيانات عن الروابط غير المباشرة التي تشير إلى صفحة تعيد التوجيه إلى هدف أو تشير إلى صفحة أساسية
      إذا ضُبط على false، فستُتجاهل الروابط غير المباشرة
      القيمة الافتراضية: true

    • include_subdomains
      النوع: boolean | null

      يشير إلى ما إذا كانت النطاقات الفرعية لـtargets ستُضمَّن في البحث
      حقل اختياري
      إذا ضُبط على false، فستُتجاهل النطاقات الفرعية
      القيمة الافتراضية: true

    • internal_list_limit
      النوع: integer | null

      الحد الأقصى لعدد العناصر داخل المصفوفات الداخلية
      حقل اختياري
      يمكنك استخدام هذا الحقل لتقييد عدد العناصر في المصفوفات التالية:
      attributes
      domain_from_platform_type

      القيمة الافتراضية: 10
      الحد الأقصى: 1000

    • intersection_mode
      النوع: string | null

      يشير إلى ما إذا كانت الروابط الخلفية ستُتقاطع
      حقل اختياري
      استخدم هذا الحقل لتقاطع أو دمج النتائج لعناوين URL المحددة
      القيم الممكنة: all، partial
      all — تستند النتائج إلى جميع الروابط الخلفية؛
      partial — تستند النتائج إلى الروابط الخلفية المتقاطعة فقط؛
      القيمة الافتراضية: all

    • limit
      النوع: integer | null

      الحد الأقصى لعدد الروابط الخلفية المعادة
      حقل اختياري

      القيمة الافتراضية: 100
      الحد الأقصى: 1000

    • offset
      النوع: integer | null

      الإزاحة في مصفوفة نتائج الروابط الخلفية المعادة
      حقل اختياري

      القيمة الافتراضية: 0
      إذا حددت القيمة 10، فسيُحذف أول عشرة روابط خلفية في مصفوفة النتائج وستُقدَّم البيانات للروابط الخلفية التالية

    • order_by
      النوع: array string[] | null

      قواعد فرز النتائج
      حقل اختياري
      يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج
      أنواع الفرز الممكنة:
      asc — تُفرز النتائج بترتيب تصاعدي
      desc — تُفرز النتائج بترتيب تنازلي
      استخدم فاصلة لتحديد نوع الفرز
      مثال:
      ["rank,desc"]
      لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
      استخدم فاصلة للفصل بين عدة قواعد فرز
      مثال:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • rank_scale
      النوع: string | null

      تحدد المقياس المستخدم لحساب وعرض قيم rank وdomain_from_rank وpage_from_rank
      حقل اختياري

      يمكنك استخدام هذا المعامل لاختيار ما إذا كانت قيم الرتب تُعرض على مقياس 0–100 أو 0–1000

      القيم الممكنة:
      one_hundred — تُعرض قيم الرتب على مقياس 0–100
      one_thousand — تُعرض قيم الرتب على مقياس 0–1000

      القيمة الافتراضية: one_thousand

      تعرّف على طريقة عمل هذا المعامل وكيفية حساب مقاييس الترتيب في مقالة مركز المساعدة هذه

    • tag
      النوع: string | null

      معرّف مهمة يحدده المستخدم
      حقل اختياري
      الحد الأقصى للأحرف هو 255
      يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
      ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

    • targets
      النوع: object | null

      النطاقات أو النطاقات الفرعية أو صفحات الويب المطلوب الحصول على الروابط لها
      حقل مطلوب
      يمكنك تعيين ما يصل إلى 20 نطاقًا أو نطاقًا فرعيًا أو صفحة ويب
      يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww.
      يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلك http:// أو https://)
      مثال:
      "targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        النوع: string | null
الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
    • cost
      النوع: number | null التنسيق: double

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • status_code
      النوع: integer | null

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

    • status_message
      النوع: string | null

      رسالة معلوماتية عامة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

    • tasks
      النوع: array (object | null)[] | null

      مصفوفة المهام

      • النوع: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveTaskInfo
        • cost
          النوع: number | null التنسيق: double

          إجمالي تكلفة المهام، بالدولار الأمريكي

        • data
          النوع: object | null

          يحتوي على المعاملات نفسها التي حددتها في طلب POST

          • propertyName
            النوع: object | null
        • id
          النوع: string | null

          معرّف المهمة معرّف مهمة فريد في نظامنا بصيغة UUID

        • path
          النوع: array (string | null)[] | null

          مسار URL

        • result
          النوع: array (object | null)[] | null

          مصفوفة نتائج

          • items
            النوع: array (object | null)[] | null

            يحتوي على بيانات الروابط الخلفية والنطاقات المُحيلة ذات الصلة

            • page_intersection
              النوع: object | null

              يحتوي على بيانات عن الصفحات التي تربط بالأهداف المقابلة المحددة في مصفوفة POST
              تُقدَّم البيانات في كائنات منفصلة تقابل الصفحات المحددة في كائن targets

              • propertyName
                النوع: array (object | null)[] | null
                • alt
                  النوع: string | null

                  النص البديل للصورة
                  سيكون هذا الحقل null إذا لم يكن type الرابط الخلفي صورة

                • anchor
                  النوع: string | null

                  نص ارتباط الرابط الخلفي

                • attributes
                  النوع: array (string | null)[] | null

                  سمات الروابط المُحيلة
                  مثال:
                  nofollow

                • backlink_spam_score
                  النوع: integer | null

                  درجة السبام للرابط الخلفي
                  تعرّف على كيفية حساب المقياس في صفحة مركز المساعدة هذه

                • dofollow
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي dofollow
                  إذا كانت القيمة false، فالرابط الخلفي nofollow

                • domain_from
                  النوع: string | null

                  النطاق الذي يشير إلى النطاق الهدف أو صفحة الويب

                • domain_from_country
                  النوع: string | null

                  رمز الدولة ISO للنطاق المُحيل

                • domain_from_ip
                  النوع: string | null

                  عنوان IP للنطاق المُحيل

                • domain_from_is_ip
                  النوع: boolean | null

                  يشير إلى ما إذا كان النطاق عنوان IP
                  إذا كانت القيمة true، يعمل النطاق كعنوان IP وليس له اسم نطاق

                • domain_from_platform_type
                  النوع: array (string | null)[] | null

                  أنواع المنصات للنطاق المُحيل

                  القيم الممكنة: cms، blogs، ecommerce، message-boards، wikis، news، organization

                • domain_from_rank
                  النوع: integer | null

                  رتبة نطاق النطاق المُحيل
                  يشير إلى رتبة النطاق وقت آخر مشاهدة للزاحف للرابط الخلفي؛
                  تُحسب domain_from_rank وفق طريقة ترتيب العُقد في قاعدة بيانات مترابطة — وهو مبدأ مستخدم في خوارزمية Google PageRank الأصلية
                  تعرّف على المقياس وكيفية حسابه في مقال مركز المساعدة هذا

                • domain_to
                  النوع: string | null

                  النطاق الذي يشير إليه الرابط الخلفي

                • first_seen
                  النوع: string | null

                  التاريخ والوقت اللذان وجد فيهما الزاحف الرابط الخلفي أول مرة
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • group_count
                  النوع: integer | null التنسيق: int64

                  يشير إلى إجمالي عدد الروابط الخلفية من هذا النطاق
                  على سبيل المثال، إذا كان mode مضبوطًا على one_per_domain، فسيشير هذا الحقل إلى إجمالي عدد الروابط الخلفية الواردة من هذا النطاق

                • indirect_link_path
                  النوع: array (object | null)[] | null

                  مسار الرابط غير المباشر
                  يشير إلى عنوان URL أو سلسلة عناوين URL تؤدي إلى url_to

                  • status_code
                    النوع: integer | null

                    رمز الحالة العام
                    يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا
                    ملاحظة: نوصي بشدة بتصميم نظام ضروري لمعالجة الحالات الاستثنائية أو الأخطاء ذات الصلة

                  • type
                    النوع: string | null

                    نوع العنصر

                  • url
                    النوع: string | null

                    عنوان URL للرابط غير المباشر

                • is_broken
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي معطوبًا
                  إذا كانت القيمة true، فالرابط الخلفي يشير إلى صفحة تستجيب برمز حالة 4xx أو 5xx

                • is_indirect_link
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي رابطًا غير مباشر
                  إذا كانت القيمة true، فالرابط الخلفي رابط غير مباشر يشير إلى صفحة تعيد التوجيه إلى url_to أو تشير إلى صفحة أساسية (canonical)

                • is_lost
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي قد أُزيل
                  إذا كانت القيمة true، فقد أُزيل الرابط الخلفي أو الصفحة بأكملها

                • is_new
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي جديدًا
                  إذا كانت القيمة true، فقد وُجد الرابط الخلفي على الصفحة آخر مرة زارها الزاحف

                • item_type
                  النوع: string | null

                  نوع الرابط
                  القيم الممكنة:
                  anchor، image، link، meta، canonical، alternate، redirect

                • last_seen
                  النوع: string | null

                  أحدث تاريخ زار فيه الزاحف الرابط الخلفي
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • links_count
                  النوع: integer | null التنسيق: int64

                  عدد الروابط الخلفية المتطابقة الموجودة في الصفحة المُحيلة

                • original
                  النوع: boolean | null

                  يشير إلى ما إذا كان الرابط الخلفي موجودًا في الصفحة المُحيلة عندما زارها الزاحف أول مرة

                • page_from_encoding
                  النوع: string | null

                  ترميز الأحرف للصفحة المُحيلة
                  مثال:
                  utf-8

                • page_from_external_links
                  النوع: integer | null

                  عدد الروابط الخارجية الموجودة في الصفحة المُحيلة

                • page_from_internal_links
                  النوع: integer | null

                  عدد الروابط الداخلية الموجودة في الصفحة المُحيلة

                • page_from_language
                  النوع: string | null

                  لغة الصفحة المُحيلة
                  بتنسيق ISO 639-1
                  مثال:
                  en

                • page_from_rank
                  النوع: integer | null

                  رتبة الصفحة للصفحة المُحيلة
                  تُحسب page_from_rank وفق طريقة ترتيب العُقد في قاعدة بيانات مترابطة — وهو مبدأ مستخدم في خوارزمية Google PageRank الأصلية
                  تعرّف على المقياس وكيفية حسابه في مقال مركز المساعدة هذا

                • page_from_size
                  النوع: integer | null

                  حجم الصفحة المُحيلة بالبايت
                  مثال:
                  63357

                • page_from_status_code
                  النوع: integer | null

                  رمز حالة HTTP الذي تعيده الصفحة المُحيلة
                  مثال:
                  200

                • page_from_title
                  النوع: string | null

                  عنوان الصفحة المُحيلة

                • prev_seen
                  النوع: string | null

                  الموعد السابق لأحدث تاريخ زار فيه الزاحف الرابط الخلفي
                  بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  مثال:
                  2019-11-15 12:57:46 +00:00

                • rank
                  النوع: integer | null

                  رتبة الرابط الخلفي
                  تُحسب rank وفق طريقة ترتيب العُقد في قاعدة بيانات مترابطة — وهو مبدأ مستخدم في خوارزمية Google PageRank الأصلية
                  تعرّف على المقياس وكيفية حسابه في مقال مركز المساعدة هذا

                • semantic_location
                  النوع: string | null

                  يشير إلى العنصر الدلالي في HTML الذي وُجد فيه الرابط الخلفي
                  يمكنك الحصول على القائمة الكاملة للعناصر الدلالية هنا
                  أمثلة:
                  article، section، summary

                • text_post
                  النوع: string | null

                  المقتطف الذي يلي نص الارتباط

                • text_pre
                  النوع: string | null

                  مقتطف نصي يسبق نص الارتباط

                • tld_from
                  النوع: string | null

                  النطاق الأعلى مستوى لعنوان URL المُحيل

                • type
                  النوع: string | null

                  نوع العنصر

                • url_from
                  النوع: string | null

                  عنوان URL للصفحة التي وُجد فيها الرابط الخلفي

                • url_from_https
                  النوع: boolean | null

                  يشير إلى ما إذا كان عنوان URL المُحيل مؤمّنًا عبر HTTPS
                  إذا كانت القيمة true، فعنوان URL المُحيل مؤمّن عبر HTTPS

                • url_to
                  النوع: string | null

                  عنوان URL الذي يشير إليه الرابط الخلفي

                • url_to_https
                  النوع: boolean | null

                  يشير إلى ما إذا كان عنوان URL الذي يشير إليه الرابط الخلفي مؤمّنًا عبر HTTPS
                  إذا كانت القيمة true، فعنوان URL مؤمّن عبر HTTPS

                • url_to_redirect_target
                  النوع: string | null

                  عنوان URL الهدف لإعادة التوجيه
                  الصفحة الهدف التي تشير إليها إعادة التوجيه

                • url_to_spam_score
                  النوع: integer | null

                  درجة السبام للصفحة المُشار إليها
                  إذا كانت القيمة null، فالزاحف لم يزر بعد صفحة الويب التي يشير إليها الرابط
                  تعرّف على كيفية حساب المقياس في صفحة مركز المساعدة هذه

                • url_to_status_code
                  النوع: integer | null

                  رمز الحالة للصفحة المُشار إليها
                  إذا كانت القيمة null، فالزاحف لم يزر بعد صفحة الويب التي يشير إليها الرابط
                  مثال:
                  200

            • summary
              النوع: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              يحتوي على ملخص تقاطعات الصفحات

              • intersections_count
                النوع: integer | null التنسيق: int64

                إجمالي عدد التقاطعات

          • items_count
            النوع: integer | null التنسيق: int64

            عدد النتائج المُعادة في مصفوفة items

          • targets
            النوع: object | null

            targets من مصفوفة POST

            • propertyName
              النوع: string | null
          • total_count
            النوع: integer | null التنسيق: int64

            العدد الإجمالي للنتائج ذات الصلة بالطلب

        • result_count
          النوع: integer | null التنسيق: int64

          عدد العناصر في مصفوفة result

        • status_code
          النوع: integer | null

          رمز حالة المهمة ينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000 يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا

        • status_message
          النوع: string | null

          الرسالة المعلوماتية للمهمة يمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا

        • time
          النوع: string | null

          وقت التنفيذ، بالثواني

    • tasks_count
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks

    • tasks_error
      النوع: integer | null التنسيق: int64

      عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

    • time
      النوع: string | null

      إجمالي وقت التنفيذ، بالثواني

    • version
      النوع: string | null

      الإصدار الحالي من API

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/dataforseo/backlinks/page_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Page Intersection