v0.2.0-beta

OpenAPI 3.1.0

Configurar tareas de YouTube Subtitles

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

post/v1/beta/dataforseo/serp/youtube/video_subtitles/task_post

Configurar tareas de YouTube Subtitles

Encola la pista de subtítulos de un vídeo de YouTube y devuelve un id de tarea en tasks[0].id. 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. El gemelo en vivo responde de inmediato y es más simple para una consulta única; usa la cola cuando el lote dure más que una llamada de herramienta.

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
- pingback_url
  Tipo: string | null
  
  URL de notificación de una tarea completada campo opcional cuando se completa una tarea, te notificaremos mediante una solicitud GET enviada a la URL que hayas especificado puedes usar la cadena ‘$id’ como variable $id y ‘$tag’ como variable $tag codificada para URL. Estableceremos los valores necesarios antes de enviar la solicitud. ejemplo: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag Nota: los caracteres especiales de pingback_url se codificarán para URL; es decir, el carácter # se codificará como %23 más información en nuestro Centro de ayuda
- postback_data
  Tipo: string | null
  
  tipo de datos de postback_url campo obligatorio si especificas postback_url corresponde al tipo de datos que se enviará a tu servidor valor posible: advanced
- postback_url
  Tipo: string | null
  
  URL para enviar los resultados de la tarea campo opcional una vez completada la tarea, enviaremos una solicitud POST con sus resultados comprimidos en formato gzip a la postback_url que hayas especificado puedes usar la cadena ‘$id’ como variable $id y ‘$tag’ como variable $tag codificada para URL. Estableceremos los valores necesarios antes de enviar la solicitud. ejemplo: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag Nota: los caracteres especiales de postback_url se codificarán para URL; es decir, el carácter # se codificará como %23 más información en nuestro Centro de ayuda
- priority
  Tipo: integer | null
  
  prioridad de la tarea campo opcional puede tomar los siguientes valores: 1 – prioridad de ejecución normal (establecida por defecto) 2 – prioridad de ejecución alta Se te cobrará un cargo adicional por las tareas con prioridad de ejecución alta. El costo puede calcularse en la página de precios.
- 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_SerpYoutubeVideoSubtitlesTaskPostResponseInfo
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_SerpYoutubeVideoSubtitlesTaskPostTaskInfo
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: object | null

array de resultados en este caso, el valor será null

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

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

Mostrar esquema

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

Operación correcta

Configurar tareas de YouTube Subtitles

AutenticaciónRequired

DataForSEO

Configurar tareas de YouTube Subtitles

Referencia de precios