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

# Plataformas suportadas

> Hosts suportados, exclusões e lista baseada no yt-dlp

<Info>
  **Base URL**

  ```
  https://api.shappire.tools/v1
  ```

  Desenvolvimento local: `http://localhost:8080/v1`

  Todas as rotas da API pública usam esse prefixo. Chaves de produção usam o prefixo `shp_live_`; em ambiente local (não-produção), o prefixo é `shp_test_`.
</Info>

Consulte a lista atualizada em tempo real:

```bash theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
curl https://api.shappire.tools/v1/platforms \
  -H "X-API-Key: $SHAPPIRE_API_KEY"
```

## YouTube não é suportado

<Warning>
  **Shappire currently does not support YouTube URLs.**

  YouTube, YouTube Shorts e YouTube Music **não funcionam** na instância principal.

  O YouTube bloqueia IPs de servidor em escala. Manter download de YouTube em produção exige custo operacional infinito e não é viável.

  URLs como `youtube.com`, `youtu.be` e `music.youtube.com` retornam `unsupported_platform` ou falham na resolução.
</Warning>

<Note>
  `GET /platforms` pode listar extratores do yt-dlp que incluem "youtube" na nomenclatura interna. Isso **não** significa que URLs do YouTube funcionam — trate YouTube como explicitamente excluído.
</Note>

## O que é suportado

A API cobre a grande maioria dos sites listados no [yt-dlp supportedsites](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md), **exceto YouTube**.

Isso inclui centenas de extratores — TikTok, Instagram, Twitter/X, Vimeo, SoundCloud, Twitch, Reddit, Facebook e muitos outros. A lista exata depende da versão do yt-dlp em produção e dos engines nativos habilitados.

Sempre valide com `GET /platforms` antes de integrar.

## Engines

| Engine   | Descrição                                                                     |
| -------- | ----------------------------------------------------------------------------- |
| `native` | Resolvers próprios para hosts selecionados (TikTok, Instagram, Twitter, etc.) |
| `yt-dlp` | Fallback para sites do ecossistema yt-dlp (sem YouTube)                       |

## Plataformas nativas (exemplos)

| Plataforma  | Vídeo | Áudio | Imagem |
| ----------- | ----- | ----- | ------ |
| TikTok      | ✓     | ✓     | —      |
| Instagram   | ✓     | ✓     | ✓      |
| Twitter / X | ✓     | ✓     | ✓      |
| Vimeo       | ✓     | ✓     | —      |
| SoundCloud  | —     | ✓     | —      |
| Twitch      | ✓     | —     | —      |
| Pinterest   | ✓     | —     | ✓      |
| Facebook    | ✓     | —     | —      |
| Snapchat    | ✓     | —     | ✓      |
| Bilibili    | ✓     | ✓     | —      |
| VK          | ✓     | ✓     | —      |

## Capacidades

| Capability | Descrição                              |
| ---------- | -------------------------------------- |
| `video`    | Download de vídeo                      |
| `audio`    | Extração de áudio                      |
| `image`    | Imagens e thumbnails em alta resolução |
| `metadata` | Título, autor, duração, thumbnail      |

## Formatos típicos

| `format`     | Saída                                |
| ------------ | ------------------------------------ |
| `video_best` | Melhor qualidade de vídeo disponível |
| `audio_best` | Melhor qualidade de áudio (MP3/M4A)  |

## Tutoriais

* [Download do TikTok](/tutorials/tiktok-download)
* [Download do Instagram](/tutorials/instagram-download)
* [Extrair áudio](/tutorials/extrair-audio)

## Erro ao enviar URL do YouTube

```json theme={"theme":{"light":"github-light","dark":"one-dark-pro"}}
{
  "error": {
    "code": "unsupported_platform",
    "message": "The platform is not supported.",
    "request_id": "req_..."
  }
}
```

Não há workaround via API. Use uma plataforma suportada ou processe YouTube fora da Shappire.