> ## Documentation Index
> Fetch the complete documentation index at: https://docs.headlesslabs.xyz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube

> YouTube permite buscar videos públicos, consultar un video por ID/URL, leer canales y listar hasta cinco publicaciones recientes. No requiere conectar una cuenta personal.

## Búsqueda

`.yt <texto>` y `.yt search <texto>` normalizan espacios y aceptan entre 2 y 160 caracteres. La búsqueda devuelve hasta cinco resultados por página; los botones anterior/siguiente solo los puede usar quien inició la consulta. El bot añade duración y estadísticas cuando la API las devuelve.

### `.youtube`

```headless-command Syntax theme={null}
.youtube [query]
```

```headless-command Example theme={null}
.yt Headless Discord bot
```

### `.youtube search`

```headless-command Syntax theme={null}
.youtube search <query>
```

```headless-command Example theme={null}
.yt s Kendrick Lamar
```

### `/youtube search`

```headless-command Syntax theme={null}
/youtube search query:<query>
```

```headless-command Example theme={null}
/youtube search query:Headless
```

## Videos y canales

El video acepta un ID o un enlace de host oficial de YouTube, como `youtu.be`, `/watch`, `/shorts`, `/embed` o `/live`. Un canal admite ID, `@handle` o URL oficial; `.yt latest <canal>` lista hasta cinco videos recientes y puede mostrar vistas, duración y fecha.

### `.youtube video`

```headless-command Syntax theme={null}
.youtube video <value>
```

```headless-command Example theme={null}
.yt v https://youtu.be/dQw4w9WgXcQ
```

### `.youtube channel`

```headless-command Syntax theme={null}
.youtube channel <value>
```

```headless-command Example theme={null}
.yt ch @YouTube
```

### `.youtube latest`

```headless-command Syntax theme={null}
.youtube latest <value>
```

```headless-command Example theme={null}
.yt l UC_x5XG1OV2P6uZZ5FSM9Ttw
```

## Cuota y cache

La protección compartida limita por defecto las búsquedas a 80 diarias y el presupuesto total a 9 000 unidades diarias; las cuotas vigentes pueden ajustarse y están acotadas en el servicio. Una búsqueda usa 100 unidades y los endpoints de metadata consultados usan una unidad por llamada. Los resultados se cachean temporalmente; cooldowns por usuario evitan consultas repetidas.

## Pasos

**1. Busca un tema**

Prueba `.yt <búsqueda>` o `/youtube search` con una frase de al menos dos caracteres.

**2. Abre un resultado**

Usa los controles del mensaje para consultar otra página; solo responde a la persona que abrió la búsqueda.

**3. Consulta un canal**

Pasa un ID, `@handle` o URL oficial a `channel` o `latest`.

## Comandos registrados

* **`.youtube [búsqueda]` (`.yt`)** — **Comando slash:** — · **Resultado:** Busca videos públicos cuando incluyes texto; sin texto muestra ayuda. · **Cooldown de prefijo:** 5 s
* **`.youtube search <texto>` (`s`, `buscar`)** — **Comando slash:** `/youtube search query` · **Resultado:** Busca hasta cinco videos; navegación interactiva limitada a quien buscó. · **Cooldown de prefijo:** 5 s
* **`.youtube video <ID|URL>` (`v`, `watch`)** — **Comando slash:** `/youtube video video_id_or_url` · **Resultado:** Muestra metadatos públicos de un video. · **Cooldown de prefijo:** 4 s
* **`.youtube channel <ID|@handle|URL>` (`c`, `ch`, `canal`)** — **Comando slash:** `/youtube channel channel_id_handle_or_url` · **Resultado:** Muestra datos públicos del canal. · **Cooldown de prefijo:** 5 s
* **`.youtube latest <canal>` (`recent`, `ultimos`, `l`)** — **Comando slash:** `/youtube latest channel` · **Resultado:** Lista hasta cinco videos recientes del canal. · **Cooldown de prefijo:** 5 s

> [!NOTE]
>
> Una cuota agotada, API sin configurar o respuesta vacía puede impedir una consulta; un resultado vacío no confirma que el canal o video no exista. Usa IDs y URLs oficiales de YouTube.

**Nota:**

Los callbacks no declaran un permiso elevado de Discord para consultar datos públicos. El comando slash raíz `/youtube` no está registrado; Discord publica los subcomandos listados en la tabla.

## Páginas relacionadas

* [Integraciones](/docs/integrations.md)
* [TikTok](/docs/integrations/tiktok.md)
* [Pinterest](/docs/integrations/pinterest.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.