Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Налаштування завдань субтитрів YouTube

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

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

DataForSEO Операції

Налаштування завдань субтитрів YouTube

​

Ставить у чергу доріжку субтитрів одного відео YouTube і повертає id завдання в tasks[0].id. Обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Live-двійник відповідає одразу і простіший для одного запиту; ставте в чергу, коли пакет переживе виклик інструмента.

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

  • Тарифікація: вартість відповіді за даними постачальника.
  • Довідкова оцінка запиту: 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

    • pingback_url
      Тип: string | null

      URL сповіщення про завершене завдання необов'язкове поле коли завдання буде виконано, ми повідомимо вас GET-запитом на вказаний вами URL рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення. приклад: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Примітка: спеціальні символи в pingback_url буде закодовано в URL; зокрема, символ # буде закодовано як %23 докладніше — у нашому довідковому центрі

    • postback_data
      Тип: string | null

      тип даних postback_url обов'язкове поле, якщо вказано postback_url відповідає типу даних, які буде надіслано на ваш сервер можливе значення: advanced

    • postback_url
      Тип: string | null

      URL для надсилання результатів завдання необов'язкове поле коли завдання буде виконано, ми надішлемо POST-запит із результатами, стисненими у форматі gzip, на вказаний вами postback_url рядок «$id» можна використовувати як змінну $id, а «$tag» — як urlencoded-змінну $tag. Перед надсиланням запиту ми підставимо потрібні значення. приклад: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Примітка: спеціальні символи в postback_url буде закодовано в URL; зокрема, символ # буде закодовано як %23 докладніше — у нашому довідковому центрі

    • priority
      Тип: integer | null

      пріоритет завдання необов'язкове поле може приймати такі значення: 1 — звичайний пріоритет виконання (встановлюється за замовчуванням) 2 — високий пріоритет виконання За завдання з високим пріоритетом виконання стягується додаткова плата. Вартість можна розрахувати на сторінці Pricing.

    • 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_SerpYoutubeVideoSubtitlesTaskPostResponseInfo
    • cost
      Тип: number | null Формат: double

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

    • status_code
      Тип: integer | null

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

    • status_message
      Тип: string | null

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

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

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

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

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

        • data
          Тип: object | null

          містить ті самі параметри, які ви вказали в POST-запиті

          • propertyName
            Тип: object | null
        • id
          Тип: string | null

          ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

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

          шлях URL

        • result
          Тип: object | null

          масив результатів у цьому випадку значення буде null

        • 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/video_subtitles/task_post
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post \
  --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": null
    }
  ]
}

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

Setting YouTube Subtitles Tasks