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

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

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
            }
          ]
        }
      ]
    }
  ]
}

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

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

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

АутентификацияRequired

DataForSEO

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

Справочная информация о ценах

Нужна помощь?