YouTube データ API

# YouTube Data API

Query YouTube videos, channels, Shorts, comments, community posts, search results and stream metadata through 34 authenticated endpoints: 32 GET and 2 POST.

## Authentication

Use your API Hop API key in the authorization header. Availability depends on enabled gateways and API key permissions; documentation alone does not confirm production availability.

```http
Authorization: Bearer YOUR_API_KEY
```

## Requests and caption tasks

GET operations use query parameters without a request body. Stream V3 uses POST with an application/json body and no query parameters; send proxy_url only in that body. The version segment selects the YouTube interface version. Unknown or duplicate fields are rejected. Keep identifiers and pagination cursors as strings, including values larger than JavaScript can safely represent as numbers.

```bash
curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"
```

## Responses

Synchronous endpoints preserve the native JSON response. Caption endpoints return success, data.id, data.status, data.result and requestId. The examples below are illustrative, not live results.

```json
{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}
```

## Billing and pagination

For synchronous requests: Prices are per successful request, not per returned item. Every page is a separate request. Most operations cost $0.001. The two V2 search variants cost $0.002; the V2 stream variant costs $0.004. See each endpoint below. Account-specific prices take precedence. Supplier volume discounts are not automatically passed through. Failed upstream calls release the reservation; settlement failures return an error and do not trigger a second upstream request.

## Caption tasks

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions returns HTTP 202 and a platform task ID, with Location: /v1/jobs/\{id\}. Query GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} every 2–5 seconds. Only the owning tenant can read the task. Result queries are free; creation costs $0.008 at the list price. No-caption results are successful and billable. The format is fixed at creation (default srt); an optional result format must match or returns HTTP 400. data.result is null until COMPLETED; tasks may end as FAILED. These endpoints retrieve existing captions, not AI transcriptions.

If submission acceptance is uncertain, the request is not replayed and its reservation may remain held until the 30-minute task deadline. A supplier result may remain pending while settlement is reconciled. A transient polling error is not a terminal task failure.

```json
{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}
```

## Scope and limitations

The web and web-v2 paths select the upstream interface family. Stream V3 supports POST retrieval with your own fixed-exit HTTP proxy. Stream endpoints return metadata and URLs, not media files or guaranteed downloads. Channel descriptions may require a second separately billed request using continuation_token. No automatic retries are made.

Stream V3 uses POST JSON over HTTPS and costs $0.003 per successful request. Provide video_id and proxy_url (http:// with an explicit port and public host); private, loopback and link-local destinations are forbidden. URL-encode reserved characters in credentials. Use a fixed exit or sticky proxy session. itags defaults to ["137", "140"]; unavailable formats fail without substitution. verify_download defaults to false. Download through the same proxy session and actual public exit IP with streams[].download_headers. Successful URL extraction (HTTP 200) is billable even when all_selected_streams_verified or streams[].verified is false. Verification samples small byte ranges, not the complete file. URLs and proxy sessions expire independently; merge separate audio/video streams yourself.

## Reference

Select an endpoint and send only its documented fields. When alternatives are listed, provide at least one field from each group. Pagination values must come from the preceding response; there is no automatic pagination.

[Complete reference](https://apihop.ai/en/docs/api-reference/youtube/reference)

## Errors

Platform errors use HTTP 400 for invalid parameters, 401 for invalid authentication, 402 for insufficient credit, 403 for denied gateway access, 429 for rate limits, and 5xx for service or supplier failures. Keep X-Request-Id for troubleshooting. Do not treat an upstream HTTP 200 with a failed business code as success.

## Sources

The endpoint list and prices were checked against the official schema and live price metadata on 2026-10-31. Live metadata takes precedence over conflicting prose prices.

[TikHub](https://docs.tikhub.io/4592766m0) · [OpenAPI](https://api.tikhub.io/openapi.json) · [Prices](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info)

認証付きの 34 個のエンドポイント（GET 32 個、POST 2 個）で、YouTube の動画、チャンネル、Shorts、コメント、コミュニティ投稿、検索結果、ストリーム情報を取得します。

認証

認証ヘッダーには API Hop API キーを指定します。利用可否は有効なゲートウェイとキーの権限に依存し、この文書は本番環境での提供を保証しません。

http

Authorization: Bearer YOUR_API_KEY

リクエストと字幕タスク

GET 操作は本文なしのクエリパラメーターを使用します。V3 ストリーム操作は application/json 本文付きの POST を使い、クエリパラメーターは受け付けません。proxy_url は本文だけに指定してください。バージョン部分で YouTube インターフェースを選択します。未知のフィールドや重複は拒否されます。識別子とページカーソルは、JavaScript の安全な整数範囲を超える値も含めて文字列として保持してください。

bash

curl --get "https://api.apihop.ai/v1/youtube/web/channels/id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "channel_name=LinusTechTips"

レスポンス

同期エンドポイントは元の JSON 応答を保持します。字幕エンドポイントは success、data.id、data.status、data.result、requestId を返します。以下は説明用の例で、実際の取得結果ではありません。

json

{"code":200,"data":{"channel_id":"UCXuqSBlHAE6Xw-yeJA0Tunw"}}

課金とページング

同期リクエストの課金：返された件数ではなく、成功したリクエストごとに課金されます。各ページは別のリクエストです。大半の操作は $0.001 です。V2 の検索バリアント 2 種は $0.002、V2 のストリームバリアントは $0.004 です。各エンドポイントの料金を確認してください。アカウント固有の料金が優先されます。供給元の数量割引は自動適用されません。上流呼び出しの失敗時は予約額を解放し、精算失敗時は上流に再送せずエラーを返します。

字幕タスク

POST https://api.apihop.ai/v1/youtube/web-v2/videos/captions は HTTP 202、プラットフォームのタスク ID、Location: /v1/jobs/\{id\} を返します。GET https://api.apihop.ai/v1/youtube/web-v2/videos/captions/result?job_id=\{id\} を 2–5 秒間隔で呼び出してください。所有テナントのみ取得できます。結果照会は無料で、作成の標準価格は $0.008 です。字幕なしも成功として課金されます。形式は作成時に固定され、既定は srt です。照会時の任意の format が異なると HTTP 400 になります。COMPLETED まで data.result は null で、FAILED になる場合もあります。既存字幕のみを取得し、AI 文字起こしは行いません。

送信が受理されたか不明な場合は再送せず、残高の予約をタスクの 30 分の期限まで保持する場合があります。上流の結果が確定していても、課金の照合中は保留になる場合があります。一時的な照会エラーはタスクの最終的な失敗を意味しません。

json

{"success":true,"data":{"id":"9007199254740993001","status":"PROCESSING","result":null},"requestId":"example"}

対象範囲と制限

web と web-v2 はインターフェースの系列を選択します。V3 では、固定出口の HTTP プロキシを持ち込んで POST でリンクを取得できます。ストリーム操作は情報と URL を返し、メディアファイルやダウンロードの成功を保証しません。チャンネル説明では continuation_token を使った別料金の 2 回目のリクエストが必要な場合があります。自動再試行は行いません。

V3 は HTTPS 経由の POST JSON を使い、成功したリクエストごとに $0.003 です。video_id と proxy_url（http://、明示的なポート、公開ホスト）を指定します。プライベート、ループバック、リンクローカル宛先は禁止で、認証情報の予約文字は URL エンコードします。固定出口またはスティッキーセッションを使ってください。itags の既定値は ["137", "140"] で、利用できない形式は自動置換せず失敗します。verify_download の既定値は false です。同じプロキシセッションと実際の公開出口 IP を使用し、streams[].download_headers を付けてダウンロードしてください。URL 取得が成功した HTTP 200 は、all_selected_streams_verified または streams[].verified が false でも課金されます。検証は少量のバイトの抽出検査で、ファイル全体の検証ではありません。URL とセッションの期限は独立しています。分離された音声と動画はクライアント側で結合します。

認証

リクエストと字幕タスク

レスポンス

字幕タスク

対象範囲と制限

リファレンス

エラー

出典