v0.2.0-beta

OpenAPI 3.1.0

Розширена Live-версія YouTube Subtitles

Felo API Support

MIT

Сервер

https://openapi.felo.ai

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

Shell Curl

DataForSEO

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

DataForSEO Операції

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

Розширена Live-версія YouTube Subtitles

Повертає доріжку субтитрів одного відео 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.

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

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

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

Тіло

application/json

Тип: array (object | null)[]
- device
  Тип: string | null
  
  тип пристрою необов'язкове поле єдине значення: desktop
- 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
  
  операційна система пристрою необов'язкове поле виберіть одне з таких значень: windows, macos значення за замовчуванням: windows
- subtitles_language
  Тип: string | null
  
  код мови оригінального тексту код мови можна отримати з результату YouTube Video Info
- subtitles_translate_language
  Тип: string | null
  
  код мови перекладеного тексту можливі значення: "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"
- tag
  Тип: string | null
  
  користувацький ідентифікатор завдання необов'язкове поле обмеження — 255 символів цей параметр дозволяє ідентифікувати завдання та зіставити його з результатом указане значення tag можна знайти в об'єкті data відповіді
- video_id
  Тип: string
  
  ID відео обов'язкове поле ID відео можна знайти в URL або в елементі 'youtube_video' результату YouTube Organic приклад: Y8Wu4rSNJms

Відповіді

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

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

status_code
Тип: integer | null

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

status_message
Тип: string | null

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

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

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

Тип: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
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

масив результатів

category
Тип: string | 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_subtitles

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

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

duration_time
Тип: number | null

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

end_time
Тип: number | null

закінчення другого тексту субтитрів

rank_absolute
Тип: integer | null

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

rank_group
Тип: integer | null

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

start_time
Тип: number | null

початок другого тексту субтитрів

text
Тип: string | null

текст, перекладений у субтитрах

type
Тип: string | null

тип елемента

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

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

language_code
Тип: string | null

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

location_code
Тип: integer | null

код локації в масиві POST

origin_language
Тип: string | null

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

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

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

кількість субтитрів у відео

title
Тип: string | null

назва відео

translate_language
Тип: string | null

код мови перекладеного тексту

unsupported_language
Тип: boolean | null

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

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

post/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "video_id": "Y8Wu4rSNJms"
  }
]'

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

{
  "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
          ],
          "unsupported_language": null,
          "translate_language": null,
          "origin_language": null,
          "category": null,
          "subtitles_count": null,
          "title": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "text": null,
              "start_time": null,
              "end_time": null,
              "duration_time": null
            }
          ]
        }
      ]
    }
  ]
}

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

Розширена Live-версія YouTube Subtitles

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

DataForSEO

Розширена Live-версія YouTube Subtitles

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