Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

الروابط الخلفية الجديدة والمفقودة بالجملة

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

الروابط الخلفية الجديدة والمفقودة بالجملة

​

أعداد الروابط الخلفية الجديدة والمفقودة لعدة targets منذ date_from — صف واحد من target وnew_backlinks وlost_backlinks. استخدمها لاكتشاف المواقع التي تكسب روابط أو تفقدها في قائمة. لهدف واحد موزّع على فترات استخدم post_dataforseo_backlinks_timeseries_new_lost_live؛ وللنطاقات المُحيلة بدلًا من الروابط، post_dataforseo_backlinks_bulk_new_lost_ref_domains_live. لا تأخذ هذه النقطة معامل حد أقصى، لذا فالخيار الوحيد هو استدعاؤها بوتيرة أقل.

مرجع التسعير

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

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

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

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

      القيمة الافتراضية: تاريخ اليوم -(ناقص) شهر واحد؛
      على سبيل المثال، إذا كان اليوم 2021-10-13، فستكون القيمة الافتراضية لـdate_from هي 2021-09-13.
      الحد الأدنى يساوي تاريخ اليوم -(ناقص) سنة واحدة؛
      على سبيل المثال، إذا كان اليوم 2021-10-13، فسيكون الحد الأدنى لـdate_from هو 2020-10-13.

      صيغة التاريخ: "yyyy-mm-dd"
      مثال:
      "2021-01-01"

    • tag
      النوع: string | null

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

    • targets
      النوع: array string[]

      النطاقات أو النطاقات الفرعية أو صفحات الويب المطلوب الحصول على الروابط الخلفية الجديدة والمفقودة لها
      حقل مطلوب
      يمكنك تعيين ما يصل إلى 1000 نطاق أو نطاق فرعي أو صفحة ويب
      يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww. ويجب تحديد الصفحة بعنوان URL مطلق (بما في ذلك http:// أو https://)
      مثال:
      "targets": [<br> "forbes.com",<br> "cnn.com",<br> "bbc.com",<br> "yelp.com",<br> "https://www.apple.com/iphone/",<br> "https://ahrefs.com/blog/",<br> "ibm.com",<br> "https://variety.com/",<br> "https://stackoverflow.com/",<br> "www.trustpilot.com"<br>]

الاستجابات
  • 200
    النوع: object | null · Response36Afe1097B20_BacklinksBulkNewLostBacklinksLiveResponseInfo
    • cost
      النوع: number | null التنسيق: double

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

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

              عدد الروابط الخلفية المفقودة
              عدد الروابط الخلفية المفقودة لـtarget

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

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

            • target
              النوع: string | null

              النطاق أو النطاق الفرعي أو صفحة الويب من مصفوفة POST

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

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

        • 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/bulk_new_lost_backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_new_lost_backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "forbes.com",
      "cnn.com",
      "bbc.com",
      "yelp.com",
      "https://www.apple.com/iphone/",
      "https://ahrefs.com/blog/",
      "ibm.com",
      "https://variety.com/",
      "https://stackoverflow.com/",
      "www.trustpilot.com"
    ],
    "date_from": "2026-08-31 11:12:35"
  }
]'
{
  "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": [
        {
          "items_count": null,
          "items": [
            {
              "target": null,
              "new_backlinks": null,
              "lost_backlinks": null
            }
          ]
        }
      ]
    }
  ]
}
Bulk New & Lost Backlinks