Migrating from TranscriptAPI.com: A Field Guide

Switching a YouTube transcript integration from TranscriptAPI.com to GetYouTubeTranscript - parameter mapping, a before/after curl example, endpoint equivalents, and the real gaps that do not map 1:1.

00:06:00 · SEP 26, 2026

簡単な回答

TranscriptAPI.comのvideo_url、format、include_timestampは、当社のvおよびlanguageパラメータに対応します - ただし、当社のパブリックAPIはformat=jsonオプションのようなセグメント単位のタイムスタンプを提供しません。プレーンな文字起こしテキストとメタデータだけが必要なら、ほぼそのまま置き換えられます。API応答自体からセグメント単位のタイムスタンプが必要な場合は、切り替える前に相違点のセクションを読んでください。

パラメータのマッピング

どちらのAPIもベアラートークンで認証し、完全なURL、短縮URL、または裸の動画IDを受け付けます。TranscriptAPIの残りの文字起こしパラメータが当社のものとどう対応するか:

TranscriptAPI.com	GetYouTubeTranscript	備考
`Authorization: Bearer KEY`	`Authorization: Bearer KEY`	x-api-keyも代替ヘッダーとして受け付けます。
`video_url`	`v（またはurl、videoId）`	同じ受付形式：完全なURL、短縮URL、または11文字のID。
`language`	`language`	当社は優先リストではなく、デフォルト付きの単一コードを受け取ります - 呼び出しごとに1つの言語をリクエストしてください。
`format=json\|text`	`（なし - 常にプレーンテキスト）`	当社の応答は常にtranscriptフィールドにフラットな文字列を返します。これはformat=textに相当します。
`include_timestamp`	`（提供されていません）`	セグメント単位のstart/durationタイムスタンプは現在パブリック応答に含まれません - 下の相違点を参照。
`send_metadata=true`	`（常に含まれる）`	title、author_name、author_url、thumbnail_urlは常に応答に含まれます - フラグは不要です。

移行前 / 移行後

TranscriptAPI.com

curl -X GET "https://transcriptapi.com/api/v2/youtube/transcript?video_url=https://youtu.be/dQw4w9WgXcQ&language=en&send_metadata=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

GetYouTubeTranscript

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ&language=en" \
  -H "Authorization: Bearer sk_live_..."

# => { "success": true, "data": { "video_id": "...", "language_code": "en",
#      "title": "...", "author_name": "...", "author_url": "...",
#      "thumbnail_url": "...", "transcript": "...", "word_count": 1847 } }

同じ動画で、どちらも1クレジット。当社側はメタデータがデフォルトで返ってくるため、send_metadataフラグを覚える必要はありません。

他のエンドポイント

TranscriptAPI.com	GetYouTubeTranscript	備考
`GET /youtube/info（無料）`	`GET /resolve?handle=...（無料）`	当社はハンドル/URLをチャンネルIDに解決します。動画レベルのメタデータは/transcriptを呼び出して応答フィールドを参照してください。
`GET /youtube/search（1クレジット）`	`GET /search?q=...（1クレジット/ページ）`	同じ考え方 - ページネーション付き検索、取得したページごとに1クレジット。
`GET /youtube/channel/resolve（無料）`	`GET /resolve?handle=...（無料）`	直接対応。
`GET /youtube/channel/videos（1/ページ）`	`GET /channel/videos?channel=...（1クレジット/ページ）`	同じページネーションモデル - 応答のcontinuationトークンをそのまま返してください。
`GET /youtube/channel/search（1クレジット）`	`GET /channel/search?channel=...&q=...（1クレジット/ページ）`	直接対応。
`GET /youtube/channel/playlists, /channel/posts`	`（対応なし）`	現在提供していません - 下の相違点を参照。

1:1で対応しない点

APIレスポンスにセグメント単位のタイムスタンプがありません。TranscriptAPIのformat=json + include_timestamp=trueはstart/duration付きのセグメントを返しますが、当社のパブリックAPIはフラットな文字起こし文字列のみを返します（セグメント単位のタイムスタンプは当社のデータベースには存在し、ウェブサイト自体のクリック可能な文字起こしビューを支えていますが、まだパブリックAPI応答には含まれていません）。
ここでのlanguageは優先リストではなく単一のコードです。TranscriptAPIはde,en,asrのようなカンマ区切りリストを左から右へ試しますが、当社はデフォルト付きの単一コードを受け取ります。フォールバックチェーンに依存していた場合は、別の値で自分で再試行してください。
チャンネルのプレイリストや投稿のエンドポイントはありません。TranscriptAPIの/channel/playlistsと/channel/postsには現在ここに対応するものがありません。

プレーンな文字起こしテキスト、メタデータ、検索、チャンネルデータでユースケースをカバーできるなら、ほぼそのまま置き換えられます - 100無料クレジット（カード不要）でサインアップし、完全な料金とエンドポイント一覧を確認するか、完全なパラメータリファレンスはAPIドキュメントをご覧ください。

移行FAQ

Q01

認証ヘッダーを変更する必要がありますか？

いいえ - どちらのAPIもAuthorization: Bearer YOUR_KEYを使用します。当社はx-api-keyも代替として受け付けます。

Q02

既存の動画URLやIDはそのまま使えますか？

はい - どちらのAPIも同じパラメータ位置（あちらはvideo_url、こちらはv）で、完全なYouTube URL、短縮youtu.be URL、または11文字の動画IDを受け付けます。

Q03

TranscriptAPIの形式のようなカンマ区切りの言語リストを送るとどうなりますか？

当社のlanguageパラメータはリストではなく単一のコードを想定しています。カンマ区切りの値はおそらく一致しません - 呼び出しごとに1つの言語をリクエストし、フォールバックチェーンが必要な場合は別の値で再試行してください。

Q04

貴社のAPIからセグメント単位のタイムスタンプを取得できますか？

現在、パブリックREST API応答からは取得できません - フラットな文字起こしテキストを返します。移行がこれに依存する場合は、提供されるまで待つか、それをサポートしているウェブサイト自体の文字起こしビューを使用してください。

Q05

試すのは無料ですか？

サインアップ時に100無料クレジット、カード不要 - プランを決める前に文字起こし、検索、チャンネルの各エンドポイントを試すのに十分です。