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 دفعة واحدة: صف واحد لكل url مع rank وmain_domain_rank وbacklinks وfirst_seen وlost_date وbacklinks_spam_score وbroken_backlinks. نسخة الهدف الواحد هي post_dataforseo_backlinks_domain_pages_summary_live. لا تأخذ هذه النقطة معامل حد أقصى، لذا فالخيار الوحيد هو استدعاؤها بوتيرة أقل.

مرجع التسعير

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

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

الجسم
application/json
  • النوع: array (object | null)[]
    • 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 ضمن الاستجابة

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

      النطاقات أو النطاقات الفرعية أو صفحات الويب المطلوب الحصول على بيانات ملخصة لها
      حقل مطلوب
      يجب تحديد النطاق أو النطاق الفرعي دون https:// وwww.
      يجب تحديد الصفحة بعنوان URL مطلق (بما في ذلك http:// أو https://)
      يمكنك تحديد ما يصل إلى 1000 صفحة أو نطاق أو نطاق فرعي في كل طلب.
      لاحظ أن عناوين URL التي تعينها في طلب واحد لا يمكن أن تنتمي إلى أكثر من 100 نطاق مختلف.

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

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

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

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

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

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

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

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

            • 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

            • main_domain_rank
              النوع: integer | null

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

            • 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، footer

              • 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

              Signed 64-bit integers (long type).

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

              يشير إلى عدد الصفحات التي تشير إلى url ذي الصلة

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

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

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

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

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

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

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

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

          • 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
Request Example for post/v1/beta/dataforseo/backlinks/bulk_pages_summary/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/bulk_pages_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "https://dataforseo.com/solutions",
      "https://dataforseo.com/about-us"
    ]
  }
]'
{
  "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,
          "items": [
            {
              "type": null,
              "url": null,
              "rank": null,
              "main_domain_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
            }
          ]
        }
      ]
    }
  ]
}
Bulk Pages Summary