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

# Integrations

> Headless provides public lookups and account connections with explicit permissions. An integration page does not imply automatic alerts or access to private data.

## Public lookups

YouTube and Roblox Avatar query provider-visible data; cooldowns, caching, and external limits apply.

Slash groups enforce a per-user, per-provider cooldown: **4 seconds** for YouTube and **5 seconds** for TikTok and Pinterest. These limits are separate from the prefix-command cooldowns listed in each guide.

### `.youtube`

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

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

### `.tiktok profile`

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

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

### `.pinterest boards`

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

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

### `.robloxavatar`

```headless-command Syntax theme={null}
/robloxavatar username:<username>
```

```headless-command Example theme={null}
/robloxavatar username:Roblox
```

> [!WARNING]
>
> APIs and OAuth scopes can limit results. A failed lookup does not prove a profile does not exist; never post OAuth tokens.

## Connected personal accounts

TikTok and Pinterest can query the account the user connected through OAuth. Do not paste tokens into Headless or connect another person's account.

## Catalog limits

This page covers integrations for the main bot. Headless Music is a separate service and is outside the scope of this guide.

## Steps

**1. Open the provider guide**

Check which data is public and which requires connecting your own account.

**2. Authorize only needed access**

Inspect the official flow's scopes and do not share credentials.

**3. Handle provider errors**

Check availability, cooldowns, and quotas before retrying lookups.

## Related pages

* [YouTube](/docs/en/integrations/youtube.md)
* [TikTok](/docs/en/integrations/tiktok.md)
* [Pinterest](/docs/en/integrations/pinterest.md)
* [Roblox Avatar](/docs/en/integrations/roblox-avatar.md)
* [Music](/docs/en/voice/music.md)


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