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/competitors/live

المنافسون

المواقع التي تشترك في نطاقات مُحيلة مع target واحد، مرتّبة حسب عدد ما تشترك فيه. يعطي كل صف target وrank وintersections — عدد النطاقات الرابطة المشتركة. يشكّل main_domain وexclude_large_domains وexclude_internal_backlinks ما يُحتسب. هؤلاء منافسون في رسم الروابط، لا منافسون في البحث؛ للأخير استخدم post_dataforseo_labs_google_serp_competitors_live. لرؤية النطاقات المشتركة الفعلية استخدم post_dataforseo_backlinks_domain_intersection_live.

مرجع التسعير

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

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

الجسم

application/json

النوع: array (object | null)[]
- exclude_internal_backlinks
  النوع: boolean | null
  
  يشير إلى ما إذا كانت الروابط الخلفية الداخلية من النطاقات الفرعية إلى target ستُستبعد من النتائج
  حقل اختياري
  إذا ضُبط على true، فلن تتضمن النتائج بيانات عن الروابط الخلفية الداخلية من النطاقات الفرعية للنطاق نفسه الخاص بـtarget
  إذا ضُبط على false، فستُضمَّن الروابط الداخلية في النتائج
  القيمة الافتراضية: true
- exclude_large_domains
  النوع: boolean | null
  
  يشير إلى ما إذا كان النطاق الكبير سيظهر في النتائج
  حقل اختياري
  إذا ضُبط على true، فستُحذف النتائج الواردة من النطاق الكبير (google.com وamazon.com وما إلى ذلك)؛
  القيمة الافتراضية: true
- 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 لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
  مثال:
  ["rank",">","100"]
  
  [["target","like","%forbes%"], "and", [["rank",">","100"],"or",["intersections",">","5"]]]
  
  القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.
  
  كائن فارغ
- limit
  النوع: integer | null
  
  الحد الأقصى لعدد النطاقات المعادة
  حقل اختياري
  القيمة الافتراضية: 100
  الحد الأقصى للقيمة: 1000
- main_domain
  النوع: boolean | null
  
  يشير إلى ما إذا كان النطاق الرئيسي فقط لـtarget سيُضمَّن في البحث
  حقل اختياري
  إذا ضُبط على true، فسيُضمَّن النطاق الرئيسي فقط في البحث؛
  القيمة الافتراضية: true
- offset
  النوع: integer | null
  
  الإزاحة في مصفوفة نتائج النطاقات المعادة
  حقل اختياري
  القيمة الافتراضية: 0
  إذا حددت القيمة 10، فسيُحذف أول عشرة نطاقات في مصفوفة النتائج وستُقدَّم البيانات للصفحات التالية
- order_by
  النوع: array string[] | null
  
  قواعد فرز النتائج
  حقل اختياري
  يمكنك استخدام القيم نفسها الموجودة في مصفوفة filters لفرز النتائج
  أنواع الفرز الممكنة:
  asc — تُفرز النتائج بترتيب تصاعدي
  desc — تُفرز النتائج بترتيب تنازلي
  استخدم فاصلة لتحديد نوع الفرز
  مثال:
  ["rank,desc"]
  لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
  استخدم فاصلة للفصل بين عدة قواعد فرز
  مثال:
  ["intersections,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 ضمن الاستجابة
- target
  النوع: string
  
  النطاق أو النطاق الفرعي أو صفحة الويب المطلوب الحصول على النطاقات المنافسة لها
  حقل مطلوب
  يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww.
  يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلك http:// أو https://)

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

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

مصفوفة العناصر

intersections
النوع: integer | null

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

rank
النوع: integer | null

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

target
النوع: string | null

نطاق المنافس

type
النوع: string | null

نوع العنصر

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

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

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/competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "filters": [
      "rank",
      ">",
      100
    ],
    "order_by": [
      "rank,desc"
    ],
    "limit": 5
  }
]'

عرض المخطط

{
  "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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "target": null,
              "rank": null,
              "intersections": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

المنافسون

المصادقةRequired

DataForSEO

المنافسون

مرجع التسعير