Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
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 العمليات

ملخص السلاسل الزمنية للروابط الخلفية

​

مقاييس الروابط الخلفية الأساسية لـtarget واحد عبر الزمن، مجمّعة حسب group_range (يوم، أسبوع، شهر). يعيد date_from وdate_to وgroup_range وعنصرًا واحدًا لكل فترة. للمكاسب والخسائر بدلًا من الإجماليات استخدم post_dataforseo_backlinks_timeseries_new_lost_live. لا تأخذ هذه النقطة معامل حد أقصى، لذا فالخيار الوحيد هو استدعاؤها بوتيرة أقل.

مرجع التسعير

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

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

الجسم
application/json
  • النوع: array (object | null)[]
    • date_from
      النوع: string | null

      تاريخ بداية النطاق الزمني
      حقل اختياري
      يشير هذا الحقل إلى التاريخ الذي سيُستخدم حدًا فاصلًا للبيانات الملخصة؛

      الحد الأدنى: 2019-01-30
      يجب ألا يتجاوز الحد الأقصى التاريخ المحدد في date_to
      صيغة التاريخ: "yyyy-mm-dd"
      مثال:
      "2021-01-01"

    • date_to
      النوع: string | null

      تاريخ نهاية النطاق الزمني
      حقل اختياري
      إذا لم تحدد هذا الحقل، فسيُستخدم تاريخ اليوم افتراضيًا
      يجب ألا يسبق الحد الأدنى التاريخ المحدد في date_from
      الحد الأقصى: تاريخ اليوم
      صيغة التاريخ: "yyyy-mm-dd"
      مثال:
      "2021-01-15"

    • group_range
      النوع: string | null

      النطاق الزمني الذي سيُستخدم لتجميع النتائج
      حقل اختياري
      القيمة الافتراضية: month
      القيم الممكنة: day، week، month، year

      ملاحظة: بالنسبة إلى day، سنعيد عناصر تقابل جميع التواريخ بين date_from وdate_to ضمناً؛
      وبالنسبة إلى week/month/year، سنعيد عناصر تقابل أسابيع/أشهر/سنوات كاملة، حيث سيشير كل عنصر إلى اليوم الأخير من الأسبوع/الشهر/السنة

      على سبيل المثال، إذا حددت:
      "group_range": "month",
      "date_from": "2022-03-23",
      "date_to": "2022-05-13"
      سنعيد العناصر الواقعة بين 2022-03-01 و2022-05-31، أي ثلاثة عناصر تقابل التواريخ التالية: 2022-03-31، 2022-04-30، 2022-05-31

      إذا لم تكن هناك بيانات لـday/week/month/year معينة، فسنعيد 0

    • include_subdomains
      النوع: boolean | null

      يشير إلى ما إذا كانت النطاقات الفرعية لـtarget ستُضمَّن في البحث
      حقل اختياري
      إذا ضُبط على false، فستُتجاهل النطاقات الفرعية
      القيمة الافتراضية: true

    • 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_BacklinksTimeseriesSummaryLiveResponseInfo
    • cost
      النوع: number | null التنسيق: double

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة نتائج

          • date_from
            النوع: string | null

            تاريخ بداية الفترة الزمنية
            بتنسيق UTC: “yyyy-mm-dd”
            مثال:
            2019-01-01

          • date_to
            النوع: string | null

            تاريخ نهاية الفترة الزمنية
            بتنسيق UTC: "yyyy-mm-dd"
            مثال:
            "2019-01-15"

          • group_range
            النوع: string | null

            group_range من مصفوفة POST

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

            يحتوي على بيانات الملخص ذات الصلة

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

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

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

              عدد الروابط الخلفية nofollow للتاريخ date المعطى

            • date
              النوع: string | null

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

            • rank
              النوع: integer | null

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

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

              عدد النطاقات المُحيلة للتاريخ date المعطى
              تشمل النطاقات المُحيلة النطاقات الفرعية التي تُحتسب نطاقات منفصلة لهذا المقياس

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

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

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

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

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

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

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

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

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

              عدد الصفحات التي تشير إلى target للتاريخ date المعطى

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

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

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

              عدد الشبكات الفرعية المُحيلة للتاريخ date المعطى

            • type
              النوع: string | null

              نوع العنصر

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

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

          • target
            النوع: string | null

            target من مصفوفة POST

        • 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
Request Example for post/v1/beta/dataforseo/backlinks/timeseries_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

{
  "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,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "rank": null,
              "backlinks": null,
              "backlinks_nofollow": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Backlinks Timeseries Summary