> ## 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.

# Pinterest

> Pinterest ofrece consultas de solo lectura para la cuenta que el usuario vinculó a Headless. Requiere OAuth configurado y los scopes `boards:read`, `pins:read` y `user_accounts:read`.

## Perfil, tableros y Pins

El grupo `.pin` sin texto muestra el perfil vinculado; con texto ejecuta una búsqueda. `profile`, `boards`, `pins`, `search` y `pin` consultan recursos disponibles para la cuenta del usuario que invoca el comando. Las listas y búsquedas usan cursores del proveedor y botones que solo puede utilizar quien inició la consulta.

### `.pinterest profile`

```headless-command Syntax theme={null}
.pinterest profile
```

```headless-command Example theme={null}
.pin profile
```

### `.pinterest boards`

```headless-command Syntax theme={null}
.pinterest boards
```

```headless-command Example theme={null}
.pin boards
```

### `.pinterest pins`

```headless-command Syntax theme={null}
.pinterest pins
```

```headless-command Example theme={null}
.pin pins
```

### `.pinterest pin`

```headless-command Syntax theme={null}
.pinterest pin <pin_id>
```

```headless-command Example theme={null}
.pin pin 99360735500167749
```

## Buscar

La búsqueda normal consulta Pins autorizados de la cuenta, normaliza espacios y acepta de 2 a 100 caracteres. La búsqueda pública Partner/global solo cambia de endpoint cuando el acceso fue aprobado y activado en el despliegue; incluso entonces requiere una cuenta vinculada y no es una función pública garantizada. La página de cuenta puede contener hasta 25 registros; Partner devuelve hasta 10.

### `.pinterest search`

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

```headless-command Example theme={null}
.pin search landscape
```

### `/pinterest search`

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

```headless-command Example theme={null}
/pinterest search query:landscape
```

## Desconectar y límites

`disconnect` borra la credencial local de Pinterest asociada al usuario. Los tokens se almacenan cifrados en PostgreSQL; el servicio no asume ni confirma revocación remota. Los enlaces de Pin deben ser IDs numéricos de 5–30 dígitos o URLs oficiales de Pinterest. Pinterest Lens y scraping no están disponibles.

### `.pinterest connect`

```headless-command Syntax theme={null}
.pinterest connect
```

```headless-command Example theme={null}
.pin connect
```

### `.pinterest disconnect`

```headless-command Syntax theme={null}
.pinterest disconnect
```

```headless-command Example theme={null}
.pin disconnect
```

## Pasos

**1. Autoriza tu cuenta**

Usa `.pin connect` o `/pinterest connect` y concede solo los scopes que aparecen en OAuth.

**2. Busca o explora**

Ejecuta `.pin <texto>`, `.pin boards`, `.pin pins` o `.pin v <ID|URL>`; solo podrás leer los recursos permitidos.

**3. Retira la credencial**

Ejecuta `.pin disconnect`; eso elimina el token local guardado por Headless.

## Comandos registrados

* **`.pinterest [texto]` (`.pin`)** — **Comando slash:** — · **Resultado:** Sin texto muestra tu perfil; con texto busca Pins accesibles. · **Cooldown de prefijo:** 6 s
* **`.pinterest profile` (`p`, `perfil`)** — **Comando slash:** `/pinterest profile` · **Resultado:** Muestra el perfil Pinterest vinculado. · **Cooldown de prefijo:** 5 s
* **`.pinterest boards` (`b`, `tableros`)** — **Comando slash:** `/pinterest boards` · **Resultado:** Lista tableros autorizados. · **Cooldown de prefijo:** 5 s
* **`.pinterest pins` (`list`, `mis-pins`)** — **Comando slash:** `/pinterest pins` · **Resultado:** Lista Pins autorizados. · **Cooldown de prefijo:** 5 s
* **`.pinterest search <texto>` (`s`, `buscar`)** — **Comando slash:** `/pinterest search query` · **Resultado:** Busca Pins visibles desde la cuenta autorizada. · **Cooldown de prefijo:** 6 s
* **`.pinterest pin <ID|URL>` (`get`, `view`, `v`, `detalle`)** — **Comando slash:** `/pinterest pin pin_url_or_id` · **Resultado:** Muestra un Pin legible por la cuenta conectada. · **Cooldown de prefijo:** 5 s
* **`.pinterest connect` (`conectar`)** — **Comando slash:** `/pinterest connect` · **Resultado:** Abre el flujo oficial para autorizar tu propia cuenta. · **Cooldown de prefijo:** 10 s
* **`.pinterest disconnect` (`desconectar`)** — **Comando slash:** `/pinterest disconnect` · **Resultado:** Elimina la credencial Pinterest local del usuario. · **Cooldown de prefijo:** 10 s

> [!WARNING]
>
> No supongas que un Pin privado es legible. Borrar la credencial local no equivale a una revocación remota confirmada; gestiona también la autorización desde el proveedor si necesitas retirarla por completo.

**Nota:**

Los callbacks no declaran permisos elevados de Discord. Las consultas usan el ID de Discord de la persona que ejecuta el comando; slash responde de forma efímera para consultas de cuenta.

## Páginas relacionadas

* [Integraciones](/docs/integrations.md)
* [TikTok](/docs/integrations/tiktok.md)
* [YouTube](/docs/integrations/youtube.md)
* [Dashboard](/docs/dashboard.md)


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