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

صفحات النطاق

صفحات target واحد التي لها روابط واردة، مع رؤية الزاحف لكل منها: main_domain وdomain وtld وpage وip وfirst_visited وprev_visited وfetch_time. استخدمها لمعرفة الصفحات التي تكسب روابط فعليًا. لأعداد الروابط الخلفية لكل صفحة بدلًا من بيانات الزحف استخدم post_dataforseo_backlinks_domain_pages_summary_live.

مرجع التسعير

القياس: تكلفة الاستجابة المُبلَّغ عنها.
تقدير الطلب المرجعي: 0.0276 دولار أمريكي.
مضاعف العميل المرجعي: 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
  
  تحديد الروابط الخلفية التي ستُعاد وتُحتسب
  حقل اختياري
  يمكنك استخدام هذا الحقل لاختيار الروابط الخلفية التي ستُعاد وتُستخدم للمقاييس المجمعة؛
  القيم الممكنة:
  all — تُعاد جميع الروابط الخلفية وتُحتسب؛
  live — تُعاد الروابط الخلفية التي عُثر عليها خلال الفحص الأخير وتُحتسب؛
  lost — تُعاد الروابط الخلفية المفقودة وتُحتسب؛
  
  القيمة الافتراضية: live
- exclude_internal_backlinks
  النوع: boolean | null
  
  يشير إلى ما إذا كانت الروابط الخلفية الداخلية من النطاقات الفرعية إلى target ستُستبعد من النتائج
  حقل اختياري
  إذا ضُبط على true، فلن تتضمن النتائج بيانات عن الروابط الخلفية الداخلية من النطاقات الفرعية للنطاق نفسه الخاص بـtarget
  إذا ضُبط على false، فستُضمَّن الروابط الداخلية في النتائج
  القيمة الافتراضية: 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 لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
  مثال:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  القائمة الكاملة لعوامل التصفية الممكنة متاحة هنا.
  
  كائن فارغ
- 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 — تُفرز النتائج بترتيب تنازلي
  استخدم فاصلة لتحديد نوع الفرز
  مثال:
  ["page_summary.backlinks,desc"]
  لاحظ أنه لا يمكن تعيين أكثر من ثلاث قواعد فرز في طلب واحد
  استخدم فاصلة للفصل بين عدة قواعد فرز
  مثال:
  ["page_summary.backlinks,desc","page_summary.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.
  مثال:
  forbes.com

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

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

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

content_encoding
النوع: string | null

نوع الترميز

domain
النوع: string | null

النطاق
النطاق الذي وُجدت فيه الصفحة

encoded_size
النوع: integer | null

حجم الصفحة بعد الترميز
يشير إلى حجم الصفحة المشفرة بالبايت

fetch_time
النوع: string | null

أحدث تاريخ ووقت زار فيهما الزاحف الصفحة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

first_visited
النوع: string | null

تاريخ ووقت أول زيارة للصفحة
التاريخ والوقت اللذان زار فيهما الزاحف هذه الصفحة أول مرة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

ip
النوع: string | null

عنوان بروتوكول الإنترنت

location
النوع: string | null

ترويسة Location
يشير إلى عنوان URL الذي تُعاد توجيه الصفحة إليه إن وُجد

main_domain
النوع: string | null

نطاق الموقع الرئيسي
نطاق الموقع الرئيسي لا يتضمن النطاقات الفرعية

media_type
النوع: string | null

أنواع الوسائط المستخدمة لعرض الصفحة

meta
النوع: object | null · Response36Afe1097B20_BacklinksPageMeta

البيانات الوصفية للصفحة

canonical
النوع: string | null

الصفحة الأساسية (canonical)

charset
النوع: string | null

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

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

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

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

وسم h1
محتوى وسوم h1

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

وسم h2
محتوى وسوم h2

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

وسم h3
محتوى وسوم h3

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

محتوى وسوم alt

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

عدد الصور في الصفحة

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

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

language
النوع: string | null

لغة محتوى الصفحة
مثال:
en

page_spam_score
النوع: integer | null

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

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

نوع المنصة

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

تفاصيل CMS

social_media_tags
النوع: object | null
propertyName
النوع: string | null
technologies
النوع: object | null

تقنيات الموقع

propertyName
النوع: string | null
title
النوع: string | null

عنوان الصفحة

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

عدد الكلمات في الصفحة

page
النوع: string | null

عنوان URL للصفحة
عنوان URL للصفحة ذي الصلة

page_summary
النوع: object | null · Response36Afe1097B20_PageSummary

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

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

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

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

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

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

عدد الروابط الواردة المعطّلة
عدد الروابط الواردة المعطّلة التي تشير إلى page

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

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

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

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

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

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

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
propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

referring_links_semantic_locations
النوع: object | null
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
propertyName
النوع: integer | null التنسيق: int64

Signed 64-bit integers (long type).

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

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

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

Signed 64-bit integers (long type).

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

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

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

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

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

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

prev_visited
النوع: string | null

الموعد السابق لأحدث تاريخ زار فيه الزاحف الصفحة
بتنسيق UTC: “yyyy-mm-dd hh-mm-ss +00:00”
مثال:
2017-01-24 13:20:59 +00:00

server
النوع: string | null

إصدار الخادم

size
النوع: integer | null

يشير إلى حجم الصفحة بالبايت

status_code
النوع: integer | null

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

tld
النوع: string | null

النطاق الأعلى مستوى
النطاق الأعلى مستوى في منطقة جذر DNS

type
النوع: string | null

نوع العنصر

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

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

target
النوع: string | null

target في مصفوفة 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/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

عرض المخطط

{
  "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,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

صفحات النطاق

المصادقةRequired

DataForSEO

صفحات النطاق

مرجع التسعير