Migrating from Supadata: A Field Guide

Isso cobre especificamente a parte de YouTube de uma integração com o Supadata. O Supadata é uma API multiplataforma - YouTube, TikTok, Instagram, X (Twitter), Facebook e arquivos de vídeo/áudio hospedados passam pelo mesmo endpoint. O GetYouTubeTranscript é só para YouTube. Se sua integração só lida com URLs do YouTube, essa é uma troca direta. Se ela também transcreve conteúdo do TikTok ou Instagram, esse tráfego não tem equivalente aqui e precisa continuar no Supadata (ou migrar para outro lugar).

Cadastre-se no painel - 100 créditos grátis, sem cartão. O cabeçalho x-api-key do Supadata funciona exatamente da mesma forma aqui, então se seu código já o envia, só mudam o valor da chave e a URL base. Também aceitamos Authorization: Bearer caso prefira padronizar por aí.

Os nomes dos parâmetros são diferentes, mas o formato da requisição é parecido:

Antes (Supadata)

curl -X GET 'https://api.supadata.ai/v1/transcript?url=https://youtu.be/dQw4w9WgXcQ' \
  -H 'x-api-key: YOUR_API_KEY'

Depois (GetYouTubeTranscript)

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "x-api-key: YOUR_API_KEY"

O formato da resposta é diferente, mas o valor principal - content vs. transcript - é uma simples renomeação:

Supadata

{ "content": "Never gonna give you up...", "lang": "en", "availableLangs": ["en", "es", "zh-TW"] }

GetYouTubeTranscript

{
  "success": true,
  "data": {
    "video_id": "dQw4w9WgXcQ",
    "language_code": "en",
    "title": "...",
    "author_name": "...",
    "author_url": "...",
    "thumbnail_url": "...",
    "transcript": "Never gonna give you up...",
    "word_count": 1847
  }
}

Um ganho real: título do vídeo, nome do canal, URL do canal e miniatura voltam em toda chamada por padrão - os metadados do Supadata não fazem parte dessa mesma resposta, então se seu código fazia uma segunda chamada para isso, provavelmente dá para remover.