v0.2.0-beta

OpenAPI 3.1.0

Отримати результати інформації про відео YouTube за id

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

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

DataForSEO Операції

get/v1/beta/dataforseo/serp/youtube/video_info/task_get/advanced/{id}

Отримати результати інформації про відео YouTube за id

Отримує результат інформації про відео YouTube з черги за id. Повертає keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count і items. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200.

Довідкові ціни

Тарифікація: вартість відповіді за даними постачальника.
Довідкова оцінка запиту: USD 0.02.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Параметри шляху

id
Тип: string
обов'язкове

ідентифікатор завдання
унікальний ідентифікатор завдання в нашій системі у форматі UUID
протягом 30 днів ви зможете будь-коли запросити за ним результати завдання

Відповіді

200
Тип: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskGetAdvancedResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoTaskGetAdvancedTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

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_video_info

items
Тип: array (object | null)[] | null

елементи результатів пошуку, знайдені в SERP

category
Тип: string | null

категорія, до якої належить відео

channel_id
Тип: string | null

ID каналу, на якому опубліковано відео

channel_logo
Тип: string | null

URL сторінки, на якій розміщено логотип каналу

channel_name
Тип: string | null

назва каналу, на якому опубліковано відео

channel_subscribers_count
Тип: object | null · Response36Afe1097B20_ChannelSubscribersCount

кількість підписників каналу

count
Тип: integer | null Формат: int64

кількість підписників

displayed_count
Тип: string | null

відображувана кількість підписників
кількість підписників, що відображається на YouTube

channel_url
Тип: string | null

URL каналу, на якому опубліковано відео

comments_count
Тип: integer | null Формат: int64

кількість коментарів до відео

description
Тип: string | null

опис відео

duration_time
Тип: string | null

тривалість відео

duration_time_seconds
Тип: integer | null

тривалість відео в секундах

is_embeddable
Тип: boolean | null

вказує, чи можна вбудовувати відео

is_live
Тип: boolean | null

вказує, чи транслюється відео наживо

keywords
Тип: array (string | null)[] | null

ключові слова, що стосуються відео
також відомі як «теги YouTube»

likes_count
Тип: integer | null Формат: int64

кількість уподобань відео

publication_date
Тип: string | null

дата публікації відео

rank_absolute
Тип: integer | null

абсолютний ранг у SERP для цільового домену
абсолютна позиція серед усіх елементів у SERP

rank_group
Тип: integer | null

ранг групи в SERP
позиція всередині групи елементів з однаковими значеннями type
позиції елементів з іншими значеннями type не враховуються в rank_group

streaming_quality
Тип: array (object | null)[] | null

масив елементів, що містять інформацію про всі можливі якості потокового відео

bitrate
Тип: integer | null

бітрейт відео

fps
Тип: integer | null

частота кадрів відео

height
Тип: integer | null

висота відео в пікселях

label
Тип: string | null

мітка елемента якості

mime_type
Тип: string | null

тип медіа відео

type
Тип: string | null

тип елемента

width
Тип: integer | null Формат: int64

ширина відео в пікселях

subtitles
Тип: array (object | null)[] | null

масив елементів, що описують властивості субтитрів у відео

is_auto_generated
Тип: boolean | null

визначає, чи створюються субтитри автоматично

is_translatable
Тип: boolean | null

визначає, чи можна перекладати субтитри

language
Тип: string | null

мова субтитрів

thumbnail_url
Тип: string | null

URL сторінки, на якій розміщено мініатюру

timestamp
Тип: string | null

дата й час публікації результату
у форматі UTC: “yyyy-mm-dd hh-mm-ss +00:00”
приклад:
2022-11-15 12:57:46 +00:00

title
Тип: string | null

назва відео

type
Тип: string | null

тип елемента

url
Тип: string | null

URL відео

video_id
Тип: string | null

ID відео, отриманий у POST-масиві

views_count
Тип: integer | null Формат: int64

кількість переглядів відео

items_count
Тип: integer | null Формат: int64

кількість результатів, повернутих у масиві items

language_code
Тип: string | null

код мови в масиві POST

location_code
Тип: integer | null

код місцеположення в масиві POST

se_domain
Тип: string | null

домен пошукової системи в масиві POST

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

video_id
Тип: string | null

ID відео, отриманий у 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

get/v1/beta/dataforseo/serp/youtube/video_info/task_get/advanced/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_info/task_get/advanced/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Показати схему

{
  "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": [
        {
          "video_id": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "video_id": null,
              "title": null,
              "url": null,
              "thumbnail_url": null,
              "channel_id": null,
              "channel_name": null,
              "channel_url": null,
              "channel_logo": null,
              "description": null,
              "views_count": null,
              "likes_count": null,
              "comments_count": null,
              "channel_subscribers_count": "[Max Depth Exceeded]",
              "publication_date": null,
              "timestamp": null,
              "keywords": [
                "[Max Depth Exceeded]"
              ],
              "category": null,
              "is_live": null,
              "is_embeddable": null,
              "duration_time": null,
              "duration_time_seconds": null,
              "subtitles": [
                "[Max Depth Exceeded]"
              ],
              "streaming_quality": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Успішна операція

Отримати результати інформації про відео YouTube за id

АвтентифікаціяRequired

DataForSEO

Отримати результати інформації про відео YouTube за id

Довідкові ціни