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

نصوص الروابط

نصوص الروابط التي تشير إلى target واحد، صف واحد لكل نص رابط مميّز مع anchor وrank وbacklinks وfirst_seen وlost_date وbacklinks_spam_score وbroken_backlinks وbroken_pages. استخدمها لترى كيف يصف الويب موقعًا ما — نصوص الروابط المفرطة في التحسين تظهر هنا. العرض على مستوى الروابط هو post_dataforseo_backlinks_backlinks_live، وعلى مستوى النطاقات post_dataforseo_backlinks_referring_domains_live.

مرجع التسعير

القياس: تكلفة الاستجابة المُبلَّغ عنها.
تقدير الطلب المرجعي: 0.033 دولار أمريكي.
مضاعف العميل المرجعي: 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
  
  تحديد الروابط الخلفية التي ستُعاد وتُحتسب
  حقل اختياري
  يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة لـtarget؛
  القيم الممكنة:
  all — تُعاد جميع الروابط الخلفية وتُحتسب؛
  live — تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛
  lost — تُعاد الروابط الخلفية المفقودة وتُحتسب؛
  
  القيمة الافتراضية: live
- exclude_internal_backlinks
  النوع: boolean | null
  
  يشير إلى ما إذا كانت الروابط الخلفية من النطاقات الفرعية لـtarget مستبعدة
  حقل اختياري
  إذا ضُبط على false، فستُحذف الروابط الخلفية من النطاقات الفرعية لـtarget ولن تتلقى النطاق نفسه في الاستجابة؛
  القيمة الافتراضية: 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 لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
  مثال:
  ["referring_links_types.anchors",">","1"]
  
  [["broken_pages",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["anchor","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.
  
  كائن فارغ
- include_indirect_links
  النوع: boolean | null
  
  يشير إلى ما إذا كانت الروابط غير المباشرة إلى target ستُضمَّن في النتائج
  حقل اختياري
  إذا ضُبط على 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
- 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 ضمن الاستجابة
- target
  النوع: string
  
  النطاق أو النطاق الفرعي أو صفحة الويب المطلوب الحصول على نصوص الروابط لها
  حقل مطلوب
  يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww.
  يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلك http:// أو https://)

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

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

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

anchor
النوع: string | null

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

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

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

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

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

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

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

broken_pages
النوع: integer | null

عدد الصفحات المعطوبة
عدد الصفحات التي تستجيب برموز حالة 4xx أو 5xx والتي تشير إليها الروابط الخلفية

first_seen
النوع: string | null

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

lost_date
النوع: string | null

التاريخ والوقت اللذان فُقد فيهما آخر رابط خلفي يحمل نص الارتباط هذا
يشير إلى التاريخ والوقت اللذين زار فيهما الزاحف الصفحة فاستجابت برمز حالة 4xx أو 5xx، أو أُزيل آخر رابط خلفي
بتنسيق UTC: "yyyy-mm-dd hh-mm-ss +00:00"
مثال:
2017-01-24 13:20:59 +00:00

rank
النوع: integer | null

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

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

يشير إلى عدد النطاقات المُحيلة

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

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

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

عدد عناوين IP المُحيلة
عدد عناوين IP التي تشير إلى هذه الصفحة

referring_links_attributes
النوع: object | null

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

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

Signed 64-bit integers (long type).

referring_links_countries
النوع: object | null

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

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

Signed 64-bit integers (long type).

referring_links_platform_types
النوع: object | null

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

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

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

Signed 64-bit integers (long type).

referring_links_semantic_locations
النوع: object | null

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

يمكنك الحصول على القائمة الكاملة للعناصر الدلالية هنا
أمثلة:
article، section، summary

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

Signed 64-bit integers (long type).

referring_links_tld
النوع: object | null

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

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

Signed 64-bit integers (long type).

referring_links_types
النوع: object | null

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

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

Signed 64-bit integers (long type).

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

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

type
النوع: string | null

نوع العنصر

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

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

target
النوع: string | null

الهدف في مصفوفة POST

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/anchors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 4,
    "order_by": [
      "backlinks,desc"
    ],
    "filters": [
      "anchor",
      "like",
      "%news%"
    ]
  }
]'

عرض المخطط

{
  "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": [
        {
          "target": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "anchor": null,
              "rank": null,
              "backlinks": null,
              "first_seen": null,
              "lost_date": null,
              "backlinks_spam_score": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

نصوص الروابط

المصادقةRequired

DataForSEO

نصوص الروابط

مرجع التسعير