Felo API PlatformFelo API Platform
Todos los endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

YouTube Subtitles Advanced en vivo

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas cliente
Shell Curl

DataForSEO

​

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

DataForSEO Operaciones

YouTube Subtitles Advanced en vivo

​

Devuelve la pista de subtítulos de un vídeo de YouTube, de forma síncrona. Devuelve keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced es la opción predeterminada; usa regular cuando solo importa la lista clasificada y html solo para comprobar qué descartó el analizador. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200.

Referencia de precios

  • Medición: Costo de respuesta reportado.
  • Estimación de referencia por solicitud: USD 0.02.
  • Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Cuerpo
application/json
  • Tipo: array (object | null)[]
    • device
      Tipo: string | null

      tipo de dispositivo campo opcional valor posible: desktop

    • language_code
      Tipo: string | null

      código de idioma del motor de búsqueda campo obligatorio si no especificas language_name si usas este campo, no necesitas especificar language_name puedes recibir la lista de idiomas disponibles del motor de búsqueda con su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/youtube/languages ejemplo: en

    • language_name
      Tipo: string | null

      nombre completo del idioma del motor de búsqueda campo obligatorio si no especificas language_code si usas este campo, no necesitas especificar language_code puedes recibir la lista de idiomas disponibles del motor de búsqueda con su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/youtube/languages ejemplo: English

    • location_code
      Tipo: integer | null

      código de ubicación del motor de búsqueda campo obligatorio si no especificas location_name si usas este campo, no necesitas especificar location_name puedes recibir la lista de ubicaciones disponibles de los motores de búsqueda con su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/youtube/locations ejemplo: 2840

    • location_name
      Tipo: string | null

      nombre completo de la ubicación del motor de búsqueda campo obligatorio si no especificas location_code si usas este campo, no necesitas especificar location_code puedes recibir la lista de ubicaciones disponibles del motor de búsqueda con su location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/youtube/locations ejemplo: United States

    • os
      Tipo: string | null

      tipo de sistema operativo del dispositivo campo opcional elige entre los siguientes valores: windows, macos valor predeterminado: windows

    • subtitles_language
      Tipo: string | null

      código de idioma del texto original puedes obtener el código de idioma en el resultado de YouTube Video Info

    • subtitles_translate_language
      Tipo: string | null

      código de idioma del texto traducido valores posibles: "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
      Tipo: string | null

      identificador de tarea definido por el usuario campo opcional el límite de caracteres es 255 puedes usar este parámetro para identificar la tarea y relacionarla con el resultado encontrarás el valor de tag especificado en el objeto data de la respuesta

    • video_id
      Tipo: string

      ID del vídeo campo obligatorio puedes encontrar el ID del vídeo en la URL o en el elemento 'youtube_video' del resultado de YouTube Organic ejemplo: Y8Wu4rSNJms

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo
    • cost
      Tipo: number | null Formato: double

      costo total de las tareas, USD

    • status_code
      Tipo: integer | null

      código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

    • status_message
      Tipo: string | null

      mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

    • tasks
      Tipo: array (object | null)[] | null

      array de tareas

      • Tipo: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
        • cost
          Tipo: number | null Formato: double

          costo total de las tareas, USD

        • data
          Tipo: object | null

          contiene los mismos parámetros que especificaste en la solicitud POST

          • propertyName
            Tipo: object | null
        • id
          Tipo: string | null

          identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

        • path
          Tipo: array (string | null)[] | null

          ruta de la URL

        • result
          Tipo: array (object | null)[] | null

          array de resultados

          • category
            Tipo: string | null

            la categoría a la que pertenece el vídeo Nota: este campo está obsoleto y siempre devuelve null

          • check_url
            Tipo: string | null

            URL directa a los resultados del motor de búsqueda puedes usarla para asegurarte de que proporcionamos resultados precisos

          • datetime
            Tipo: string | null

            fecha y hora en que se recibió el resultado en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” ejemplo: 2019-11-15 12:57:46 +00:00

          • item_types
            Tipo: array (string | null)[] | null

            tipos de resultados de búsqueda en la SERP contiene los tipos de resultados de búsqueda (items) encontrados en la SERP. elemento posible: youtube_subtitles

          • items
            Tipo: array (object | null)[] | null

            elementos de resultados de búsqueda encontrados en la SERP

            • duration_time
              Tipo: number | null

              duración de los subtítulos en segundos

            • end_time
              Tipo: number | null

              el segundo en que termina el texto subtitulado

            • rank_absolute
              Tipo: integer | null

              rank absoluto en la SERP para el dominio de destino
              posición absoluta entre todos los elementos de la SERP

            • rank_group
              Tipo: integer | null

              clasificación de grupo en el SERP
              posición dentro de un grupo de elementos con valores de type idénticos
              las posiciones de los elementos con valores de type diferentes se omiten de rank_group

            • start_time
              Tipo: number | null

              el segundo en que comienza el texto subtitulado

            • text
              Tipo: string | null

              texto traducido en los subtítulos

            • type
              Tipo: string | null

              tipo de elemento

          • items_count
            Tipo: integer | null Formato: int64

            el número de resultados devueltos en el array items

          • language_code
            Tipo: string | null

            código de idioma en un array POST

          • location_code
            Tipo: integer | null

            código de ubicación en un array POST

          • origin_language
            Tipo: string | null

            código de idioma del texto original

          • se_domain
            Tipo: string | null

            dominio del motor de búsqueda en un array POST

          • spell
            Tipo: object | null · Response36Afe1097B20_SpellInfo

            autocorrección del motor de búsqueda si el motor de búsqueda proporcionó resultados para una palabra clave corregida, especificaremos la palabra clave corregida por el motor de búsqueda y el tipo de autocorrección

            • keyword
              Tipo: string | null

              palabra clave obtenida como resultado de la autocorrección del motor de búsqueda los resultados se proporcionarán para la palabra clave corregida

            • type
              Tipo: string | null

              tipo de autocorrección valores posibles: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo y Yandex solo admiten el siguiente tipo de autocorrección: including_results_for

          • subtitles_count
            Tipo: integer | null Formato: int64

            número de subtítulos del vídeo

          • title
            Tipo: string | null

            título del vídeo

          • translate_language
            Tipo: string | null

            código de idioma del texto traducido

          • unsupported_language
            Tipo: boolean | null

            indica si el sistema no admite el idioma

          • video_id
            Tipo: string | null

            ID del vídeo recibido en un array POST

        • result_count
          Tipo: integer | null Formato: int64

          número de elementos en el array de resultados

        • status_code
          Tipo: integer | null

          código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí

        • status_message
          Tipo: string | null

          mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

        • time
          Tipo: string | null

          tiempo de ejecución, segundos

    • tasks_count
      Tipo: integer | null Formato: int64

      el número de tareas en el array de tareas

    • tasks_error
      Tipo: integer | null Formato: int64

      el número de tareas en el array de tareas devueltas con un error

    • time
      Tipo: string | null

      tiempo total de ejecución, en segundos

    • version
      Tipo: string | null

      la versión actual de la API

    application/json
  • 400

    No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

  • 401

    Se requiere una clave de API de Felo válida.

  • 402

    La solicitud no puede continuar porque no se cumple un requisito de facturación.

  • 403

    La cuenta no tiene permiso para realizar esta operación.

  • 429

    Se ha alcanzado un límite de solicitudes o de gasto.

  • 502

    El servicio no pudo completar la solicitud.

  • 503

    La API o el servicio de facturación no están disponibles temporalmente.

  • 504

    El servicio agotó el tiempo de espera al procesar la solicitud.

  • default

    Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

    application/json
Request Example for 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
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Live YouTube Subtitles Advanced