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

YouTube Organic المتقدم المباشر

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

DataForSEO

​

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

DataForSEO العمليات

YouTube Organic المتقدم المباشر

​

يعيد النتائج المرتّبة لكلمة مفتاحية على YouTube بشكل متزامن. يعيد keyword وtype وse_domain وlocation_code وlanguage_code وcheck_url وdatetime وspell وrefinement_chips وitem_types وitems_count وitems. advanced هو الخيار الافتراضي؛ خذ regular عندما تكون القائمة المرتّبة هي كل المهمة، وhtml فقط للتحقق مما أسقطه المحلّل. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200.

مرجع التسعير

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

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

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

      عمق التحليل حقل اختياري عدد كتل النتائج في SERP القيمة الافتراضية: 20 الحد الأقصى: 200 ملاحظة: ستُحتسب على حسابك رسوم عن كل SERP يحتوي على ما يصل إلى 20 نتيجة؛ وبالتالي، قد يؤدي تعيين عمق كتل أعلى من 20 إلى رسوم إضافية إذا أعاد محرك البحث أكثر من 20 نتيجة؛ إذا كان عمق الكتل المحدد أعلى من عدد النتائج في الاستجابة، فسيُعاد الفرق تلقائيًا إلى رصيد حسابك

    • device
      النوع: string | null

      نوع الجهاز حقل اختياري إرجاع نتائج لنوع جهاز معين القيم المتاحة: desktop، mobile

    • keyword
      النوع: string

      الكلمة المفتاحية حقل مطلوب يمكنك تحديد حتى 700 حرف في حقل keyword سيُفكّ ترميز جميع %## (وسيُفكّ ترميز المحرف ‘+’ إلى مسافة) إذا كنت تحتاج إلى استخدام المحرف “%” في keyword، فحدده كـ“%25”؛ إذا كنت تحتاج إلى استخدام المحرف “+” في keyword، فحدده كـ“%2B”؛ تعرّف على المزيد حول قواعد وقيود حقلي keyword وkeywords في واجهات DataForSEO API في مقال مركز المساعدة هذا

    • language_code
      النوع: string | null

      رمز لغة محرك البحث حقل مطلوب إذا لم تحدد language_name إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_name يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/youtube/languages مثال: en

    • language_name
      النوع: string | null

      الاسم الكامل للغة محرك البحث حقل مطلوب إذا لم تحدد language_code إذا استخدمت هذا الحقل، فلا حاجة لتحديد language_code يمكنك الحصول على قائمة لغات محرك البحث المتاحة مع language_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/youtube/languages مثال: English

    • location_code
      النوع: integer | null

      رمز موقع محرك البحث حقل مطلوب إذا لم تحدد location_name إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_name يمكنك الحصول على قائمة مواقع محركات البحث المتاحة مع location_code الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/youtube/locations مثال: 2840

    • location_name
      النوع: string | null

      الاسم الكامل لموقع محرك البحث حقل مطلوب إذا لم تحدد location_code إذا استخدمت هذا الحقل، فلا حاجة لتحديد location_code يمكنك الحصول على قائمة مواقع محرك البحث المتاحة مع location_name الخاص بها عبر إرسال طلب منفصل إلى https://api.dataforseo.com/v3/serp/youtube/locations مثال: United States

    • os
      النوع: string | null

      نظام تشغيل الجهاز حقل اختياري إذا حددت desktop في حقل device، فاختر من القيم التالية: windows، macos القيمة الافتراضية: windows إذا حددت mobile في حقل device، فاختر من القيم التالية: android، ios القيمة الافتراضية: android

    • search_param
      النوع: string | null

      معاملات إضافية لاستعلام البحث حقل اختياري مثال: sp=EgIQAg%253D%253D

    • tag
      النوع: string | null

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

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

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

    • status_code
      النوع: integer | null

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

    • status_message
      النوع: string | null

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

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

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

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

          مصفوفة النتائج

          • check_url
            النوع: string | null

            عنوان URL مباشر لنتائج محرك البحث يمكنك استخدامه للتأكد من أننا قدّمنا نتائج دقيقة

          • datetime
            النوع: string | null

            تاريخ ووقت استلام النتيجة بالتنسيق: “yyyy-mm-dd hh-mm-ss +00:00” مثال: 2019-11-15 12:57:46 +00:00

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

            أنواع نتائج البحث في SERP تحتوي على أنواع نتائج البحث (items) الموجودة في SERP. أنواع العناصر الممكنة: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist

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

            عناصر نتائج البحث الموجودة في SERP

            • block_name
              النوع: string | null

              اسم الكتلة في SERP
              مثال:
              "People also watched"

            • block_rank
              النوع: integer | null

              رتبة الكتلة في SERP
              الموضع بين جميع الكتل في SERP

            • channel_id
              النوع: string | null

              معرّف القناة

            • rank_absolute
              النوع: integer | null

              الرتبة المطلقة في SERP للنطاق المستهدف
              الموضع المطلق بين جميع العناصر في SERP

            • rank_group
              النوع: integer | null

              رتبة المجموعة في SERP
              الموضع ضمن مجموعة عناصر لها قيم type متطابقة
              تُستبعد مواضع العناصر ذات قيم type المختلفة من rank_group

            • type
              النوع: string | null

              نوع العنصر

            • url
              النوع: string | null

              عنوان URL للقناة

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

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

          • keyword
            النوع: string | null

            الكلمة المفتاحية المستلمة في مصفوفة POST تُعاد الكلمة المفتاحية مع فك ترميز %## (سيُفكّ ترميز المحرف '+' إلى مسافة)

          • language_code
            النوع: string | null

            رمز اللغة في مصفوفة POST

          • location_code
            النوع: integer | null

            رمز الموقع في مصفوفة POST

          • se_domain
            النوع: string | null

            نطاق محرك البحث في مصفوفة POST

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

            العدد الإجمالي للنتائج في SERP

          • spell
            النوع: object | null · Response36Afe1097B20_SpellInfo

            التصحيح التلقائي لمحرك البحث إذا قدّم محرك البحث نتائج لكلمة مفتاحية جرى تصحيحها، فسنحدد الكلمة المفتاحية التي صححها محرك البحث ونوع التصحيح التلقائي

            • keyword
              النوع: string | null

              الكلمة المفتاحية التي تم الحصول عليها نتيجة التصحيح التلقائي لمحرك البحث ستُقدَّم النتائج للكلمة المفتاحية المصححة

            • type
              النوع: string | null

              نوع التصحيح التلقائي القيم الممكنة: did_you_mean, showing_results_for, no_results_found_for, including_results_for ملاحظة: يدعم Yahoo وYandex نوع التصحيح التلقائي التالي فقط: including_results_for

        • 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/serp/youtube/organic/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "audi"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "block_rank": null,
              "block_name": null,
              "channel_id": null,
              "url": null
            }
          ]
        }
      ]
    }
  ]
}

عملية ناجحة

Live YouTube Organic Advanced