Descripción de YouTube
Un video sin capítulos y con una descripción de tres líneas es invisible tanto para el espectador como para el buscador. Este endpoint toma el contenido de un video y devuelve una opción de título, una descripción completa, una lista de etiquetas y capítulos con marcas de tiempo: los metadatos que deciden si un video llega a encontrarse siquiera.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué los metadatos pesan tanto en video
A diferencia de una página web, un video no puede ser hojeado por un algoritmo de búsqueda de la misma forma que el texto: el título, la descripción y las etiquetas hacen la mayor parte del trabajo de contarle tanto al espectador como al buscador qué hay realmente adentro. Un creador que logra una grabación excelente pero escribe una descripción apurada de dos frases deja sin terminar la mitad del trabajo, la parte de que lo encuentren, y esa es exactamente la brecha que cierra este endpoint.
Qué se recibe y por qué importan los capítulos
La respuesta incluye una sugerencia de título, una descripción estructurada tanto para la lectura como para la búsqueda, una lista de etiquetas relevantes y capítulos con marcas de tiempo que señalan los momentos clave del video. Los capítulos cumplen doble función: le permiten al espectador saltar directo a la parte que quiere, y le dan a la plataforma una estructura explícita para entender un video largo como una secuencia de temas distintos en vez de un bloque sin diferenciar.
Cómo ha cambiado la forma de escribir descripciones de video
Las primeras plataformas de video trataban la descripción como algo secundario, un recuadro de texto debajo del contenido real. Eso cambió cuando los creadores notaron que una descripción bien construida, con marcas de tiempo, enlaces y un resumen claro, afectaba de forma medible cómo se recomendaban los videos, y escribir descripciones se volvió una habilidad propia, distinta de escribir guiones o editar. Este endpoint empaqueta esa habilidad en una solicitud, en vez de dejarla como un ejercicio manual video por video.
Quién ahorra más tiempo con esto
Los canales que publican con cualquier tipo de calendario regular son los que más lo sienten: escribir una descripción genuinamente buena para cada video es la tarea que se apura o se salta cuando se acumula el trabajo pendiente. Los canales educativos y de formato largo se benefician especialmente de la generación de capítulos, ya que un video de 40 minutos sin capítulos pierde a los espectadores que no encuentran la sección que buscaban.
Lo que sigue bajo su control
El resultado es un borrador sólido, no una publicación final: los títulos deberían seguir ajustándose a la voz de su canal, y cualquier capítulo o etiqueta que mencione afirmaciones sensibles merece una revisión humana antes de salir publicado. Los resultados se entregan por webhook firmado o por enlace firmado válido durante 24 horas, y el contenido de video enviado se elimina al terminar el período de retención y nunca se usa para entrenar.
Qué puede hacer con ella
Calendario semanal de publicación
Un creador que publica todos los jueves genera título, descripción y capítulos apenas termina la edición, en vez de escribir los metadatos bajo presión de la fecha límite.
Videos educativos de formato largo
Un canal de cursos obtiene capítulos con marcas de tiempo para una clase de 90 minutos de forma automática, permitiendo a los estudiantes ir directo al tema que necesitan.
Limpieza del catálogo anterior
Un canal con dos años de videos y descripciones pobres pasa sus subidas antiguas por el endpoint para agregar capítulos y etiquetas adecuadas de forma retroactiva.
Equipos de contenido con varios canales
Una agencia que gestiona los canales de varios clientes estandariza la calidad de las descripciones en todos ellos sin contratar a alguien dedicado solo a los metadatos.
Preguntas frecuentes
¿Qué devuelve la API para generar descripciones de YouTube?
Una sugerencia de título, una descripción completa, una lista de etiquetas relevantes y capítulos con marcas de tiempo para el video que envía.
¿Necesito enviar el archivo de video en sí?
Envía los detalles del contenido del video para su procesamiento; revise los formatos de entrada aceptados por el endpoint antes de integrarlo.
¿Existe período de prueba gratuito?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cómo se cobra?
$0.003 por solicitud más $0.0135 por cada video procesado.
¿Puedo procesar muchos videos en un solo lote?
Sí, las solicitudes son asíncronas, así que puede encolar todo un catálogo pendiente y recoger los metadatos de cada video a medida que se completan.
¿Genera los capítulos de forma automática?
Sí, los capítulos con marcas de tiempo que señalan los momentos clave del video vienen incluidos en la respuesta junto con el título, la descripción y las etiquetas.
¿Cómo recibo los resultados?
Por webhook firmado, recomendado para flujos automatizados, o por enlace firmado válido durante 24 horas.
¿Qué pasa si una solicitud falla?
Se reintenta automáticamente hasta tres veces y nunca se cobra si finalmente falla; en su lugar recibe un error claro.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/seo/youtube-meta \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/seo/youtube-meta", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/youtube-meta",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/youtube-meta", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/youtube-meta", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.youtube_meta",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |