v0.2.0-beta

OpenAPI 3.1.0

نظرة عامة على Whois للنطاق

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/domain_analytics/whois/overview/live

نظرة عامة على Whois للنطاق

سجلات Whois مُثراة بمقاييس SEO. يحمل كل عنصر domain وcreated_datetime وchanged_datetime وexpiration_datetime وupdated_datetime وfirst_seen وepp_status_codes وtld وregistered وregistrar، إضافةً إلى metrics وbacklinks_info. تُرقّم صفحاتها بـlimit وoffset وoffset_token، وتُصفّى عبر الحقول في get_dataforseo_domains_whois_available_filters.

مرجع التسعير

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

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

الجسم

application/json

النوع: array (object | null)[]
- filters
  النوع: array (object | null)[] | null
  
  مصفوفة معاملات تصفية النتائج
  حقل اختياري
  يمكنك إضافة عدة عوامل تصفية دفعةً واحدة (8 كحد أقصى)
  يجب تعيين معامل منطقي and أو or بين الشروط
  المعاملات المدعومة:
  regex، <، <=، >، >=، =، <>، in، not_in، like، not_like
  يمكنك استخدام المعامل % مع like وnot_like لمطابقة أي سلسلة من صفر أو أكثر من الأحرف
  
  كائن فارغ
- limit
  النوع: integer | null
  
  الحد الأقصى لعدد النطاقات المعادة
  حقل اختياري
  القيمة الافتراضية: 100
  الحد الأقصى للقيمة: 1000
- offset
  النوع: integer | null
  
  الإزاحة في مصفوفة نتائج العناصر المعادة
  حقل اختياري
  القيمة الافتراضية: 0
  إذا حددت القيمة 10، فسيُحذف أول عشرة items من مصفوفة النتائج وستُقدَّم البيانات للعناصر التالية؛
  ملاحظة: نوصي باستخدام هذا المعامل فقط عند استرداد ما يصل إلى 10,000 نتيجة؛ لاسترداد أكثر من 10,000 نتيجة، استخدم offset_token بدلًا منه
- offset_token
  النوع: string | null
  
  رمز الإزاحة للطلبات اللاحقة
  حقل اختياري
  يُقدَّم في الحقل نفسه في استجابة كل طلب؛
  استخدم هذا المعامل لتجنّب انتهاء المهلة عند محاولة الحصول على أكثر من 100,000 نتيجة في طلب واحد؛
  بتحديد قيمة offset_token الفريدة من مصفوفة الاستجابة، ستحصل على النتائج اللاحقة للمهمة الأولية؛
  قيم offset_token فريدة لكل مهمة لاحقة
  ملاحظة: إذا حُدِّد offset_token في الطلب، فيجب أن تكون جميع المعاملات الأخرى مطابقة للطلب السابق
  تعرّف على المزيد حول هذا المعامل في مركز المساعدة
- order_by
  النوع: array string[] | null
  
  قواعد ترتيب النتائج
  حقل اختياري
  يمكنك استخدام القيم نفسها كما في مصفوفة filters لترتيب النتائج
  أنواع الترتيب الممكنة:
  asc — ستُرتَّب النتائج بترتيب تصاعدي
  desc — ستُرتَّب النتائج بترتيب تنازلي
  تُستخدم الفاصلة كفاصل
  مثال:
  ["metrics.organic.pos_1,desc"]
  القاعدة الافتراضية:
  ["metrics.organic.count,desc"]
  لاحظ أنه لا يمكنك تعيين أكثر من ثلاث قواعد ترتيب في طلب واحد
  يجب استخدام فاصلة لفصل عدة قواعد ترتيب
  مثال:
  ["expiration_datetime,asc","metrics.organic.etv,desc","metrics.organic.pos_1,desc"]
- tag
  النوع: string | null
  
  معرّف مهمة يحدده المستخدم
  حقل اختياري
  الحد الأقصى للأحرف هو 255
  يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة
  ستجد قيمة tag المحددة في كائن data ضمن الاستجابة

الاستجابات

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

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

status_code
النوع: integer | null

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

status_message
النوع: string | null

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

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

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

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

يحتوي على بيانات الترتيب وحركة المرور

مصفوفة items

backlinks_info
النوع: object | null · Response36Afe1097B20_BacklinksInfo

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

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

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

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

متوسط عدد روابط dofollow

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

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

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

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

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

متوسط عدد الصفحات المُحيلة

time_update
النوع: string | null

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

changed_datetime
النوع: string | null

تاريخ ووقت تغيّر إدخال النطاق
تاريخ ووقت (بتنسيق ISO 8601) آخر تعديل لإدخال النطاق
مثال:
"2021-01-14 08:36:28 +00:00"

created_datetime
النوع: string | null

تاريخ ووقت التسجيل
تاريخ ووقت (بتنسيق ISO 8601) أول تسجيل للنطاق
مثال:
"1997-03-29 03:00:00 +00:00"

domain
النوع: string | null

اسم النطاق

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

رموز حالة بروتوكول التزويد الموسّع
حالة تسجيل اسم النطاق كما حددتها ICANN

expiration_datetime
النوع: string | null

تاريخ ووقت انتهاء صلاحية النطاق
تاريخ ووقت (بتنسيق ISO 8601) انتهاء صلاحية النطاق
مثال:
"2022-11-26 17:21:23 +00:00"

first_seen
النوع: string | null

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

metrics
النوع: object | null · Response36Afe1097B20_MetricsBundleInfo

بيانات ترتيب تتعلق بالنطاق المحدد

organic
النوع: object | null · Response36Afe1097B20_MetricsInfo

بيانات الترتيب وحركة المرور من البحث العضوي

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

العدد الإجمالي لنتائج SERP العضوية التي تحتوي على النطاق

estimated_paid_traffic_cost
النوع: number | null

التكلفة المقدّرة لتحويل حركة المرور العضوية إلى مدفوعة
تمثّل التكلفة الشهرية المقدّرة لتشغيل الإعلانات (بالدولار الأمريكي) لجميع الكلمات المفتاحية التي يتصدّرها نطاق ما
يُحتسب المقياس كحاصل ضرب قيم etv العضوية وقيم cpc المدفوعة، ويشير إلى تكلفة جلب الحجم المقدّر من حركة المرور العضوية الشهرية عبر إعلانات PPC في بحث Google
اعرف المزيد عن كيفية حساب المقياس في مقالة مركز المساعدة هذه

etv
النوع: number | null

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

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

انخفاض الترتيب يشير إلى عدد العناصر المصنّفة لهذا النطاق التي انخفض ترتيبها في بحث Google

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

العناصر المصنّفة المفقودة يشير إلى عدد العناصر المصنّفة لهذا النطاق التي كانت تُعرض سابقًا في نتائج SERP، لكن لم يُعثر عليها في الفحص الأخير

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

عدد العناصر المصنّفة الجديدة يشير إلى عدد العناصر المصنّفة الجديدة التي عُثر عليها لهذا النطاق

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

ارتفاع الترتيب يشير إلى عدد العناصر المصنّفة لهذا النطاق التي ارتفع ترتيبها في بحث Google

pos_1
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المرتبة #1

pos_11_20
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #11-20

pos_2_3
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #2-3

pos_21_30
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #21-30

pos_31_40
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #31-40

pos_4_10
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #4-10

pos_41_50
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #41-50

pos_51_60
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #51-60

pos_61_70
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #61-70

pos_71_80
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #71-80

pos_81_90
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #81-90

pos_91_100
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #91-100

paid
النوع: object | null · Response36Afe1097B20_MetricsInfo

بيانات الترتيب وحركة المرور من البحث المدفوع

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

العدد الإجمالي لنتائج SERP العضوية التي تحتوي على النطاق

estimated_paid_traffic_cost
النوع: number | null

التكلفة المقدّرة لتحويل حركة المرور العضوية إلى مدفوعة
تمثّل التكلفة الشهرية المقدّرة لتشغيل الإعلانات (بالدولار الأمريكي) لجميع الكلمات المفتاحية التي يتصدّرها نطاق ما
يُحتسب المقياس كحاصل ضرب قيم etv العضوية وقيم cpc المدفوعة، ويشير إلى تكلفة جلب الحجم المقدّر من حركة المرور العضوية الشهرية عبر إعلانات PPC في بحث Google
اعرف المزيد عن كيفية حساب المقياس في مقالة مركز المساعدة هذه

etv
النوع: number | null

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

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

انخفاض الترتيب يشير إلى عدد العناصر المصنّفة لهذا النطاق التي انخفض ترتيبها في بحث Google

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

العناصر المصنّفة المفقودة يشير إلى عدد العناصر المصنّفة لهذا النطاق التي كانت تُعرض سابقًا في نتائج SERP، لكن لم يُعثر عليها في الفحص الأخير

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

عدد العناصر المصنّفة الجديدة يشير إلى عدد العناصر المصنّفة الجديدة التي عُثر عليها لهذا النطاق

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

ارتفاع الترتيب يشير إلى عدد العناصر المصنّفة لهذا النطاق التي ارتفع ترتيبها في بحث Google

pos_1
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المرتبة #1

pos_11_20
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #11-20

pos_2_3
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #2-3

pos_21_30
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #21-30

pos_31_40
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #31-40

pos_4_10
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #4-10

pos_41_50
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #41-50

pos_51_60
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #51-60

pos_61_70
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #61-70

pos_71_80
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #71-80

pos_81_90
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #81-90

pos_91_100
النوع: integer | null

عدد SERP العضوية التي يتصدّر فيها النطاق المراتب #91-100

registered
النوع: boolean | null

حالة تسجيل النطاق
إذا كانت false، فقد انتهت صلاحية تسجيل اسم النطاق
ملاحظة: ستبقى النطاقات المنتهية في قاعدة البيانات لفترة قصيرة فقط

registrar
النوع: string | null

مُسجِّل النطاق
إذا كانت null، فمُسجِّل النطاق غير معروف
مثال:
NameCheap, Inc.

tld
النوع: string | null

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

updated_datetime
النوع: string | null

تاريخ ووقت تحديث النطاق
تاريخ ووقت (بتنسيق ISO 8601) آخر تحديث للنطاق
مثال:
"2021-01-29 13:59:38 +00:00"

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

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

offset
النوع: integer | null

قيمة إزاحة النتائج المحددة في طلب POST

offset_token
النوع: 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/domain_analytics/whois/overview/live

curl https://openapi.felo.ai/v1/beta/dataforseo/domain_analytics/whois/overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "limit": 2,
    "filters": [
      [
        "epp_status_codes",
        "in",
        [
          "client_transfer_prohibited",
          "client_update_prohibited"
        ]
      ]
    ]
  }
]'

عرض المخطط

{
  "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,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "domain": null,
              "created_datetime": null,
              "changed_datetime": null,
              "expiration_datetime": null,
              "updated_datetime": null,
              "first_seen": null,
              "epp_status_codes": [
                "[Max Depth Exceeded]"
              ],
              "tld": null,
              "registered": null,
              "registrar": null,
              "metrics": "[Max Depth Exceeded]",
              "backlinks_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

نظرة عامة على Whois للنطاق

المصادقةRequired

DataForSEO

نظرة عامة على Whois للنطاق

مرجع التسعير