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 العمليات

post/v1/beta/dataforseo/backlinks/domain_intersection/live

تقاطع النطاقات

النطاقات التي تربط بعدة أهداف دفعة واحدة. ⚠️ targets هنا كائن مفهرس حسب الموضع — {"1": "a.com", "2": "b.com"} — وليس المصفوفة التي تأخذها نقاط النهاية الجماعية. يزيل exclude_targets مواقع من المقارنة. يحمل كل صف domain_intersection وsummary لكل هدف. استخدمها لمعرفة من يربط بمنافسيك وليس بك. المكافئ على مستوى الصفحة هو post_dataforseo_backlinks_page_intersection_live.

مرجع التسعير

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

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

الجسم

application/json

النوع: array (object | null)[]
- backlinks_filters
 النوع: array (object | null)[] | null
 
 تصفية الروابط الخلفية الخاصة بـtarget
 حقل اختياري
 يمكنك استخدام هذا الحقل لتصفية الروابط الخلفية الأولية التي ستُضمَّن في مجموعة البيانات الخاصة بالمقاييس المجمعة لـtarget
 يمكنك تصفية الروابط الخلفية حسب جميع الحقول المتاحة في استجابة نقطة النهاية هذه
 باستخدام هذا المعامل، يمكنك تضمين الروابط الخلفية dofollow فقط في الاستجابة وإنشاء مجموعة بيانات روابط خلفية مرنة لحساب المقاييس لها
 مثال:
 "backlinks_filters": [["dofollow", "=", true]]
 
 كائن فارغ
- backlinks_status_type
 النوع: string | null
 
 تحديد الروابط الخلفية التي ستُعاد وتُحتسب
 حقل اختياري
 يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة لـtargets؛
 القيم الممكنة:
 all — تُعاد جميع الروابط الخلفية وتُحتسب؛
 live — تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛
 lost — تُعاد الروابط الخلفية المفقودة وتُحتسب؛
 
 القيمة الافتراضية: live
- exclude_internal_backlinks
 النوع: boolean | null
 
 يشير إلى ما إذا كانت الروابط الخلفية من النطاقات الفرعية لـtarget مستبعدة
 حقل اختياري
 إذا ضُبط على false، فستُحذف الروابط الخلفية من النطاقات الفرعية لـtarget ولن تتلقى النطاق نفسه في الاستجابة؛
 القيمة الافتراضية: true
- exclude_targets
 النوع: array string[] | null
 
 النطاقات أو النطاقات الفرعية أو صفحات الويب التي تريد استبعادها
 حقل اختياري
 يمكنك تحديد ما يصل إلى 10 نطاقات أو نطاقات فرعية أو صفحات ويب
 إذا استخدمت هذه المصفوفة، فستتضمن النتائج النطاقات المُحيلة التي تربط بـtargets ولكنها لا تربط بـexclude_targets
 مثال:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "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.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.
 
 كائن فارغ
- include_indirect_links
 النوع: boolean | null
 
 يشير إلى ما إذا كانت الروابط غير المباشرة إلى targets ستُضمَّن في النتائج
 حقل اختياري
 إذا ضُبط على true، فستتضمن النتائج بيانات عن الروابط غير المباشرة التي تشير إلى صفحة تعيد التوجيه إلى هدف أو تشير إلى صفحة أساسية
 إذا ضُبط على false، فستُتجاهل الروابط غير المباشرة
 القيمة الافتراضية: true
- include_subdomains
 النوع: boolean | null
 
 يشير إلى ما إذا كانت النطاقات الفرعية لـtarget ستُضمَّن في البحث
 حقل اختياري
 إذا ضُبط على false، فستُتجاهل النطاقات الفرعية
 القيمة الافتراضية: true
- internal_list_limit
 النوع: integer | null
 
 الحد الأقصى لعدد العناصر داخل المصفوفات الداخلية
 حقل اختياري
 يمكنك استخدام هذا الحقل لتقييد عدد العناصر في المصفوفات التالية:
 referring_links_tld
 referring_links_types
 referring_links_attributes
 referring_links_platform_types
 referring_links_semantic_locations
 
 القيمة الافتراضية: 10
 الحد الأقصى: 1000
- intersection_mode
 النوع: string | null
 
 يشير إلى ما إذا كانت الروابط الخلفية ستُتقاطع
 حقل اختياري
 استخدم هذا الحقل لتقاطع أو دمج النتائج للنطاقات المحددة
 القيم الممكنة: all، partial
 all — تستند النتائج إلى جميع الروابط الخلفية؛
 partial — تستند النتائج إلى الروابط الخلفية المتقاطعة فقط؛
 القيمة الافتراضية: all
- limit
 النوع: integer | null
 
 الحد الأقصى لعدد النتائج المعادة
 حقل اختياري
 القيمة الافتراضية: 100
 الحد الأقصى: 1000
- offset
 النوع: integer | null
 
 الإزاحة في مصفوفة النتائج المعادة
 حقل اختياري
 القيمة الافتراضية: 0
 إذا حددت القيمة 10، فسيُحذف أول عشرة روابط خلفية في مصفوفة النتائج وستُقدَّم البيانات للروابط الخلفية التالية
- order_by
 النوع: array string[] | null
 
 قواعد فرز النتائج
 حقل اختياري
 يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج
 أنواع الفرز الممكنة:
 asc — تُفرز النتائج بترتيب تصاعدي
 desc — تُفرز النتائج بترتيب تنازلي
 استخدم فاصلة لتحديد نوع الفرز
 مثال:
 ["backlinks,desc"]
 لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
 استخدم فاصلة للفصل بين عدة قواعد فرز
 مثال:
 ["backlinks,desc","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": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 النوع: string | null

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

النوع: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveTaskInfo
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

يحتوي على النطاقات التي تربط بجميع targets من مصفوفة POST

domain_intersection
النوع: object | null

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

propertyName
النوع: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
النوع: integer | null التنسيق: int64

يشير إلى عدد الروابط الخلفية

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

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

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

عدد الروابط الخلفية المعطوبة

broken_pages
النوع: integer | null

عدد الصفحات المعطوبة

first_seen
النوع: string | null

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

lost_date
النوع: string | null

التاريخ والوقت اللذان فُقد فيهما آخر رابط خلفي من target هذا
يشير إلى التاريخ والوقت اللذين زار فيهما الزاحف الصفحة فاستجابت برمز حالة 4xx أو 5xx، أو أُزيل آخر رابط خلفي
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2019-11-15 12:57:46 +00:00

rank
النوع: integer | null

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

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

عدد النطاقات المُحيلة

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

عدد النطاقات التي تشير برابط nofollow واحد على الأقل إلى الهدف المقابل

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

عدد عناوين IP المُحيلة

referring_links_attributes
النوع: object | null

سمات الروابط المُحيلة
يشير إلى سمات الروابط المُحيلة وعدد الروابط لكل سمة

propertyName
النوع: integer | null

Integer numbers.

referring_links_countries
النوع: object | null

رموز الدول ISO للروابط المُحيلة
يشير إلى رموز الدول ISO للنطاقات التي توجد فيها الروابط المُحيلة وعدد الروابط لكل دولة

referring_links_platform_types
النوع: object | null

أنواع المنصات المُحيلة
يشير إلى أنواع المنصات المُحيلة وعدد الروابط لكل منصة

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

propertyName
النوع: integer | null

Integer numbers.

referring_links_semantic_locations
النوع: object | null

المواضع الدلالية للروابط المُحيلة
يشير إلى العناصر الدلالية في HTML التي توجد فيها الروابط المُحيلة وعدد الروابط لكل موضع دلالي
يمكنك الحصول على القائمة الكاملة للعناصر الدلالية هنا

propertyName
النوع: integer | null

Integer numbers.

referring_links_tld
النوع: object | null

النطاقات الأعلى مستوى للروابط المُحيلة
يحتوي على النطاقات الأعلى مستوى وعدد الروابط المُحيلة لكل منها

propertyName
النوع: integer | null

Integer numbers.

referring_links_types
النوع: object | null

أنواع الروابط المُحيلة
يشير إلى أنواع الروابط المُحيلة وعدد الروابط لكل نوع
القيم الممكنة:
anchor، image، link، meta، canonical، alternate، redirect

propertyName
النوع: integer | null

Integer numbers.

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

عدد النطاقات الرئيسية المُحيلة

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

عدد النطاقات الرئيسية التي تشير برابط nofollow واحد على الأقل إلى target

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

يشير إلى عدد الصفحات التي تشير إلى target

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

عدد الصفحات المُحيلة التي تشير برابط nofollow واحد على الأقل إلى target

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

عدد الشبكات الفرعية المُحيلة

target
النوع: string | null

النطاق الذي يربط بالهدف المقابل من مصفوفة POST

type
النوع: string | null

نوع العنصر

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

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

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

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

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

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

targets
النوع: object | null

النطاقات أو النطاقات الفرعية أو صفحات الويب الهدف في مصفوفة 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

post/v1/beta/dataforseo/backlinks/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": 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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

تقاطع النطاقات

المصادقةRequired

DataForSEO

تقاطع النطاقات

مرجع التسعير