Migrating from Supadata: A Field Guide

Switching a YouTube transcript integration from Supadata to GetYouTubeTranscript - parameter mapping, the x-api-key header that carries over unchanged, response-shape differences, and where the two products genuinely don't match (multi-platform support, sync vs. job-polling).

00:06:00 · SEP 26, 2026

簡単な回答

エンドポイントを変更してx-api-keyヘッダーはそのまま使えます: https://api.supadata.ai/v1/transcript?url=... は https://getyoutubetranscript.com/api/v1/transcript?v=... になります - 同じヘッダー形式で、新しいキーが1つ増えるだけです。
01

この移行が対象とする人

これはSupadata連携のうちYouTube部分だけを対象としています。SupadataはYouTube、TikTok、Instagram、X(Twitter)、Facebook、ホスティングされた動画/音声ファイルすべてが同じエンドポイントを通るマルチプラットフォームAPIです。GetYouTubeTranscriptはYouTube専用です。連携がYouTubeのURLしか扱わないなら、これは単純な置き換えです。TikTokやInstagramのコンテンツも文字起こししている場合、そのトラフィックにはここに相当するものがなく、Supadataに残す(または別の場所に移す)必要があります。

02

APIキーを取得する

ダッシュボードでサインアップしてください - 100無料クレジット、カード不要です。Supadataのx-api-keyヘッダーはここでもまったく同じように機能するので、既にコードで送信しているなら、変わるのはキーの値とベースURLだけです。Authorization: Bearerで統一したい場合はそちらも使えます。

03

リクエストをマッピングする

パラメータ名は異なりますが、リクエストの形は近いです:

Supadataこちら備考
urlv完全なURLまたは11文字の動画IDを直接受け付けます - 常に完全なyoutube.comリンクを組み立てる必要はありません。
langlanguageカンマ区切りの優先リストではなく、デフォルトのフォールバック付きで単一の言語コードを受け付けます。省略すると利用可能なものが返ります。
text / mode—生セグメント/プレーンテキストの切り替えや、ネイティブ対AI生成のモード切り替えはありません - 1つのエンドポイントが常に動画ごとに1つの正規の文字起こしを返します。
x-api-key headerx-api-key or Authorization: Bearerどちらのヘッダー形式も機能します。クライアントが既に送信している方をそのまま使ってください。

変更前 (Supadata)

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

変更後 (GetYouTubeTranscript)

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

レスポンスをマッピングする

レスポンスの形は異なりますが、中心的な値 - contentとtranscript - は単純なリネームです:

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
  }
}

実質的な利点として、動画タイトル、チャンネル名、チャンネルURL、サムネイルがデフォルトで毎回の呼び出しで返ってきます - Supadataのメタデータは同じレスポンスに含まれていないため、そのために2回目の呼び出しをしていたなら、おそらく削除できます。

注意

1対1の置き換えにならない3つの点:

  • TikTok、Instagram、X、Facebookのサポートはありません - YouTubeのみです。
  • すべてのリクエストは同期処理で、アップストリームへのタイムアウトは25秒です(超えるとリトライ可能なUPSTREAM_TIMEOUTエラーを返します)- 長い動画向けのジョブID・ポーリング方式はありません。
  • native/auto/generateのモード切り替えはありません - どのように取得したかを公開せず、動画ごとに1つの文字起こしを返します。

完全なパラメータリファレンスとすべてのエラーコードはAPIドキュメントにあります。100無料クレジットで、本番導入前に切り替えをテストできます - 現在の料金はYouTube文字起こしAPIページをご覧ください。

移行に関するFAQ

Q01

既存のx-api-keyヘッダーは変更なしで使えますか?

ヘッダー名と形式は同一です - 変わるのはキーの値とベースURLだけです。同じコード内の他の場所で既にAuthorization: Bearerリクエストを送信している場合、それもここで機能するので、移行中に両方を並行して動かす場合は認証スタイルを1つに統一できます。

Q02

TikTok/Instagram/Xの文字起こし呼び出しはどうなりますか?

ここには相当するものがありません - この製品はYouTube専用です。そのトラフィックはSupadata(またはプラットフォーム固有の代替)に残し、YouTubeのURLだけをこのAPIに送ってください。

Q03

長い動画向けのジョブポーリング方式はなくなりますか?

はい - ここでのすべてのリクエストは同期処理で、25秒のアップストリームタイムアウトに制限されます。ほとんどのYouTube動画では文字起こしの取得が速いため実用上の違いはありません。異常に長いコンテンツの場合、タイムアウトしたリクエストはポーリングするジョブではなく、リトライ可能なエラーコードを返します。

Q04

Supadataのmodeパラメータのようなネイティブ対AI生成の切り替えはありますか?

いいえ - 1つのエンドポイントが動画ごとに1つの正規の文字起こしを返します。ネイティブ字幕とAI生成字幕の選択に特に依存していた場合、その制御は現在ここには存在しません。

Q05

移行のテストにはいくらかかりますか?

サインアップ時の100無料クレジット、カード不要 - 本番トラフィックを切り替える前に、実際の動画でパラメータマッピングとレスポンス形式を検証するのに十分です。

関連記事