Felo API PlatformFelo API Platform
همه endpointهای 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 در APIهای DataForSEO در این مقاله مرکز راهنما بیشتر بدانید

    • 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

            تاریخ و زمان دریافت نتیجه در قالب UTC: “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