YouTube API: 動画 — 動画 ID による詳細

Q: この YouTube API メソッドはどのようなデータを返しますか？

このメソッドは 動画 に対して「動画 ID による詳細」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

このエンドポイントの機能

この API メソッドで構築できるもの

まず結果と一般的なワークフローを確認し、次にパラメーターと動作するリクエスト例に進んでください。

このエンドポイントが役立つこと

レスポンスは、利用可能な動画のフィールドを、正規化された V2 形式またはプラットフォーム固有の V1 形式で提供します。

使用に適した場面

オブジェクトが既にわかっていて、製品でその現在の公開コンテキストが必要な場合に「動画 ID による詳細」を使用します。

主なユースケース

レコードのエンリッチメント

製品の既知のオブジェクトを YouTube の公開フィールドで補完します。

データの検証

後続の処理の前に、識別子と現在の公開コンテキストを確認します。

分析の準備

オブジェクトの詳細をレポート、評価、関連リクエストの入力として使用します。

利用できるバージョン

レスポンスのバージョン

どちらのバージョンも同じタスクを解決し、同じパラメーターを受け付けます。切り替えを使ってレスポンス構造を比較し、クライアントが想定するバージョンを選んでください。

レスポンスのバージョン V2

このページでバージョンを切り替えると、同じドキュメント URL でレスポンス構造を比較できます。

共通する点

認証、必須パラメーター、リクエストの形は V1 と V2 で同じです。実際には、エンドポイントのパスを組み立てるときとレスポンスを読み取るときにバージョンを選びます。

バージョン間で異なる点

主な違いはレスポンスのエンベロープです。新しい連携では V2 を使用し、既存のクライアント契約との互換性が必要な場合にのみ V1 を残してください。

使い方

メソッドの呼び出し方

どちらのバージョンでも、同じ API キーのヘッダーと同じクエリパラメーターを使用します。このドキュメントでは、まず共通のパラメーターを示し、次に各バージョンのパスとコードスニペットを示します。

入力パラメーター

共通パラメーター

パラメーター	必須	型	例	説明
`video_id`	はい	`str`	`5aS-8QCRdGE`	選択したプラットフォームにおける動画の ID。

バージョン別のリクエストパス

V2

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v2/youtube.com/videos/details-by-video-id

正規化された形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v2/youtube.com/videos/details-by-video-id

必須パラメーター

video_id

任意のパラメーター

なし

URL の例

https://www.scrapestorm.net/api/v2/youtube.com/videos/details-by-video-id?video_id=5aS-8QCRdGE

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/videos/details-by-video-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'video_id=5aS-8QCRdGE'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/youtube.com/videos/details-by-video-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "video_id": "5aS-8QCRdGE",
}

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/youtube.com/videos/details-by-video-id";

const params = new URLSearchParams({
  video_id: "5aS-8QCRdGE",
});

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  video_id: "5aS-8QCRdGE",
};

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "video_id" => "5aS-8QCRdGE",
];

try {
    $response = $client->request("GET", "/api/v2/youtube.com/videos/details-by-video-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/youtube.com/videos/details-by-video-id"

    params := url.Values{}
    params.Set("video_id", "5aS-8QCRdGE")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

バージョン別のリクエストパス

V1

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v1/youtube.com/videos/details-by-video-id

プラットフォーム固有の形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v1/youtube.com/videos/details-by-video-id

必須パラメーター

video_id

任意のパラメーター

なし

URL の例

https://www.scrapestorm.net/api/v1/youtube.com/videos/details-by-video-id?video_id=5aS-8QCRdGE

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/youtube.com/videos/details-by-video-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'video_id=5aS-8QCRdGE'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/youtube.com/videos/details-by-video-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "video_id": "5aS-8QCRdGE",
}

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/youtube.com/videos/details-by-video-id";

const params = new URLSearchParams({
  video_id: "5aS-8QCRdGE",
});

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  video_id: "5aS-8QCRdGE",
};

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "video_id" => "5aS-8QCRdGE",
];

try {
    $response = $client->request("GET", "/api/v1/youtube.com/videos/details-by-video-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/youtube.com/videos/details-by-video-id"

    params := url.Values{}
    params.Set("video_id", "5aS-8QCRdGE")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

レスポンス例

バージョン別のライブレスポンス

プレビューには主要なフィールドとコレクションの最初の要素が含まれているため、レスポンスの形をすばやく確認できます。バージョンを切り替えると JSON の形式が変わります。

レスポンス例

V2 レスポンスの JSON

検証済みの例

このコンパクトな JSON の例は、V2 の直近の成功した検証実行から取得したものです。

{
  "success": true,
  "status": "ok",
  "search_context": {
    "video_id": "5aS-8QCRdGE"
  },
  "data": {
    "video": {
      "author": {
        "url": "https://www.youtube.com/@mkbhd",
        "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
        "username": "mkbhd",
        "display_name": "Marques Brownlee",
        "verified": true,
        "subscriber_count": 21100000,
        "avatar_url": "https://example.com/image.jpg",
        "avatar_urls": "https://example.com/image.jpg"
      },
      "url": "https://www.youtube.com/watch?v=5aS-8QCRdGE",
      "created_at": "2026-04-14",
      "video_id": "5aS-8QCRdGE",
      "title": "The Unreleased Rollable Smartphone!",
      "description": "This phone never came out. But they got really close to dropping a rollable phone\n\nJerryRigEverything teardown:    • I'm not supposed to have this...  \n\nMKBHD Merch: http://shop…",
      "hashtags": [],
      "emails": [],
      "external_links": [
        {
          "url": "http://shop.MKBHD.com",
          "label": null,
          "link_type": "shop"
        },
        {
          "url": "https://goo.gl/B3AWV5",
          "label": null,
          "link_type": "website"
        }
      ],
      "view_count": 2195294,
      "like_count": 72324,
      "comment_count": 4600,
      "ai_summary": "Marques Brownlee examines the hardware and software features of an unreleased rollable prototype from LG. This device showcases a unique expanding screen mechanism, complex engi…"
    },
    "related_videos": {
      "count": 20,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@Mrwhosetheboss",
            "channel_id": "UCMiJRAwDNSNzuYeN2uWa0pA",
            "username": "Mrwhosetheboss",
            "display_name": "Mrwhosetheboss"
          },
          "url": "https://www.youtube.com/watch?v=vlEOOtiaUu8",
          "video_id": "vlEOOtiaUu8",
          "title": "I tested phones that shouldn’t EXIST",
          "published_time": "8 days ago",
          "duration_seconds": 1347,
          "duration_text": "22:27",
          "view_count": 4200000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/vlEOOtiaUu8/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDzeROxp42rb0xFoS2ZNoGmDJq_dg",
              "width": 168,
              "height": 94
            },
            {
              "url": "https://i.ytimg.com/vi/vlEOOtiaUu8/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBKtNrr9rQhY8Qc8jzKpcu7NeaG9Q",
              "width": 336,
              "height": 188
            },
            {
              "_more_items": 1
            }
          ]
        },
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee"
          },
          "url": "https://www.youtube.com/watch?v=HLUamwXQ218&pp=ugUEEgJlbg%3D%3D",
          "video_id": "HLUamwXQ218",
          "title": "The Problem with this “Ultra Luxury” Smartphone",
          "published_time": "6 months ago",
          "duration_seconds": 932,
          "duration_text": "15:32",
          "view_count": 3200000,
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/HLUamwXQ218/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLAs9qQ677bgPr-mFnz6JE6MXpjy9g",
              "width": 168,
              "height": 94
            },
            {
              "url": "https://i.ytimg.com/vi/HLUamwXQ218/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLCjEti94y82V_5wSHNZLen2e91E5g",
              "width": 336,
              "height": 188
            },
            {
              "_more_items": 1
            }
          ]
        },
        {
          "_more_items": 18
        }
      ]
    },
    "popular_moments": {
      "top_moments": [
        {
          "start_seconds": 467.22,
          "end_seconds": 473.21,
          "duration_seconds": 5.99,
          "time_text": "7:47-7:53",
          "intensity": 1.0,
          "rank": 1
        },
        {
          "start_seconds": 155.74,
          "end_seconds": 161.73,
          "duration_seconds": 5.99,
          "time_text": "2:35-2:41",
          "intensity": 0.882215409278172,
          "rank": 2
        },
        {
          "_more_items": 1
        }
      ],
      "timeline": [
        {
          "start_seconds": 0.0,
          "end_seconds": 5.99,
          "duration_seconds": 5.99,
          "time_text": "0:00-0:05",
          "intensity": 0.7332834639165496
        },
        {
          "start_seconds": 5.99,
          "end_seconds": 11.98,
          "duration_seconds": 5.99,
          "time_text": "0:05-0:11",
          "intensity": 0.6063383718780821
        },
        {
          "_more_items": 98
        }
      ]
    }
  }
}

レスポンス例

V1 レスポンスの JSON

検証済みの例

このコンパクトな JSON の例は、V1 の直近の成功した検証実行から取得したものです。

{
  "success": true,
  "status": "ok",
  "search_context": {
    "video_id": "5aS-8QCRdGE"
  },
  "data": {
    "responseContext": {
      "serviceTrackingParams": [
        {
          "service": "CSI",
          "params": [
            {
              "key": "c",
              "value": "WEB"
            },
            {
              "key": "cver",
              "value": "2.20260715.04.00"
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "service": "GFEEDBACK",
          "params": [
            {
              "key": "logged_in",
              "value": "0"
            },
            {
              "key": "visitor_data",
              "value": "Cgt4N0JiRG5EMEVXRSjq_fTSBjIKCgJVUxIEGgAgDWLfAgrcAjIwLllUPUNfMWpRMHJlQk1McFpvcW96LW54NS03VzZrZUhaazNJU0pJVjh4bHM1NVdlakdMbjktUm5CeDVTaTAxVHhYc0ZGVkZ1a184cU9qNkVhazdpR2NoaXptT1gxYTBpa3Bxdm9tXzVDeHFTUHRleWRhc2huTS03VVRXaVF0RURkMng0aTkzNmNQVUNqZ3FKNnM1cnVUZUxKNkxDY1c5dkpLUkg3ODRmR2tKT293NkVQQUhRdlYtZEtBemwzeG5hYkE3RlJqeV9zOEdNeU1COE91NnNGdEtFZ3ExeERGWFBnOFJkR1BnZTJ5YjM0U2tjNHE0ZmxtTVdSMk5nbEQ4eEFrckpsQXN2R0pURmpWQWFCeVJ5LWVvNGQ5Ni1UdUlBRDl1VThSdFVoSDVscVFjZ196YjF0aEo3aFVRSXNyeU8zVUt2TGFGXzB1eXgxNTd4QTRQZWh1YlpaQQ%3D%3D"
            }
          ]
        },
        {
          "_more_items": 2
        }
      ],
      "mainAppWebResponseContext": {
        "loggedOut": true,
        "trackingParam": "k5_fmPxhoXZReDboIFkE4bIwnUp3mSwshe0ingjXyBLXUNCqtU88D8MfkHRMkusYh7BwOcCw59TLtslLKPQGSS"
      },
      "responseId": "IhMI8eXYnNXflQMV4RxXAR1rvxkT",
      "webResponseContextExtensionData": {
        "webResponseContextPreloadData": {
          "preloadMessageNames": [
            "twoColumnWatchNextResults",
            "results",
            {
              "_more_items": 91
            }
          ]
        },
        "webPrefetchData": {
          "navigationEndpoints": [
            {
              "clickTrackingParams": "IhMI8eXYnNXflQMV4RxXAR1rvxkTMgxyZWxhdGVkLWF1dG9I4ejFhJDer9LlAZoBBQgDEPgdygEEXrX1bw==",
              "commandMetadata": "…",
              "watchEndpoint": "…"
            },
            {
              "clickTrackingParams": "IhMI8eXYnNXflQMV4RxXAR1rvxkTMgxyZWxhdGVkLWF1dG9I4ejFhJDer9LlAZoBBQgDEPgdygEEXrX1bw==",
              "commandMetadata": "…",
              "watchEndpoint": "…"
            },
            {
              "_more_items": 1
            }
          ]
        },
        "hasDecorated": true
      }
    },
    "contents": {
      "twoColumnWatchNextResults": {
        "results": {
          "results": {
            "contents": [
              "…",
              "…",
              {
                "_more_items": 3
              }
            ],
            "trackingParams": "CLwBELovIhMI8eXYnNXflQMV4RxXAR1rvxkT"
          }
        },
        "secondaryResults": {
          "secondaryResults": {
            "results": [
              "…",
              "…",
              {
                "_more_items": 19
              }
            ],
            "trackingParams": "CFYQqTAiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "targetId": "watch-next-feed"
          }
        },
        "autoplay": {
          "autoplay": {
            "sets": [
              "…"
            ],
            "countDownSecs": 5,
            "trackingParams": "CFUQ4ZIBIhMI8eXYnNXflQMV4RxXAR1rvxkT"
          }
        }
      }
    },
    "currentVideoEndpoint": {
      "clickTrackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
      "commandMetadata": {
        "webCommandMetadata": {
          "url": "/watch?v=5aS-8QCRdGE",
          "webPageType": "WEB_PAGE_TYPE_WATCH",
          "rootVe": 3832
        }
      },
      "watchEndpoint": {
        "videoId": "5aS-8QCRdGE",
        "watchEndpointSupportedOnesieConfig": {
          "html5PlaybackOnesieConfig": {
            "commonConfig": {
              "url": "https://rr1---sn-gjo-w43s.googlevideo.com/initplayback?source=youtube&oeis=1&c=WEB&oad=3200&ovd=3200&oaad=11000&oavd=11000&ocs=700&oewis=1&oputc=1&ofpcc=1&msp=1&odepv=1&id=e5a4bef100917461&ip=212.119.41.135&initcwndbps=3055000&mt=1784495366&oweuc=&pxtags=Cg4KAnR4Egg1MTkyOTU2OA&rxtags=Cg4KAnR4Egg1MTkyOTU2Ng%2CCg4KAnR4Egg1MTkyOTU2Nw%2CCg4KAnR4Egg1MTkyOTU2OA"
            }
          }
        }
      }
    },
    "trackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
    "playerOverlays": {
      "playerOverlayRenderer": {
        "endScreen": {
          "watchNextEndScreenRenderer": {
            "results": [
              "…",
              "…",
              {
                "_more_items": 10
              }
            ],
            "title": {
              "simpleText": "You may also like..."
            },
            "trackingParams": "CEgQ-lwiEwjx5dic1d-VAxXhHFcBHWu_GRM="
          }
        },
        "autoplay": {
          "playerOverlayAutoplayRenderer": {
            "title": {
              "simpleText": "Up next"
            },
            "videoTitle": {
              "accessibility": "…",
              "simpleText": "Reviewing EVERY Samsung Galaxy S Ever!"
            },
            "byline": {
              "runs": "…"
            },
            "pauseText": {
              "simpleText": "Autoplay is paused"
            },
            "background": {
              "thumbnails": "…",
              "lightColorPalette": "…",
              "darkColorPalette": "…"
            },
            "countDownSecs": 8,
            "cancelButton": {
              "buttonRenderer": "…"
            },
            "nextButton": {
              "buttonRenderer": "…"
            },
            "trackingParams": "CEQQ5JIBIhMI8eXYnNXflQMV4RxXAR1rvxkT",
            "closeButton": {
              "buttonRenderer": "…"
            },
            "thumbnailOverlays": [
              "…"
            ],
            "preferImmediateRedirect": false,
            "videoId": "eKVTFXQPAhs",
            "publishedTimeText": {
              "simpleText": "2 years ago"
            },
            "webShowNewAutonavCountdown": true,
            "webShowBigThumbnailEndscreen": false,
            "shortViewCountText": {
              "accessibility": "…",
              "simpleText": "9M views"
            },
            "countDownSecsForFullscreen": 3
          }
        },
        "shareButton": {
          "buttonRenderer": {
            "style": "STYLE_OPACITY",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "icon": {
              "iconType": "SHARE"
            },
            "navigationEndpoint": {
              "clickTrackingParams": "CEIQ5ZYBIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "shareEntityServiceEndpoint": "…"
            },
            "tooltip": "Share",
            "trackingParams": "CEIQ5ZYBIhMI8eXYnNXflQMV4RxXAR1rvxkT"
          }
        },
        "addToMenu": {
          "menuRenderer": {
            "trackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv"
          }
        },
        "videoDetails": {
          "playerOverlayVideoDetailsRenderer": {
            "title": {
              "simpleText": "The Unreleased Rollable Smartphone!"
            },
            "subtitle": {
              "runs": "…"
            },
            "channelAvatar": "https://example.com/image.jpg",
            "onTap": {
              "clickTrackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
              "showEngagementPanelEndpoint": "…"
            }
          }
        },
        "autonavToggle": {
          "autoplaySwitchButtonRenderer": {
            "onEnabledCommand": {
              "clickTrackingParams": "CEEQ9bUEIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "setSettingEndpoint": "…"
            },
            "onDisabledCommand": {
              "clickTrackingParams": "CEEQ9bUEIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "setSettingEndpoint": "…"
            },
            "enabledAccessibilityData": {
              "accessibilityData": "…"
            },
            "disabledAccessibilityData": {
              "accessibilityData": "…"
            },
            "trackingParams": "CEEQ9bUEIhMI8eXYnNXflQMV4RxXAR1rvxkT",
            "enabled": true
          }
        },
        "decoratedPlayerBarRenderer": {
          "decoratedPlayerBarRenderer": {
            "playerBar": {
              "multiMarkersPlayerBarRenderer": "…"
            }
          }
        },
        "fullscreenQuickActionsBar": {
          "quickActionsViewModel": {
            "quickActionButtons": [
              "…",
              "…",
              {
                "_more_items": 3
              }
            ]
          }
        },
        "speedmasterUserEdu": {
          "speedmasterEduViewModel": {
            "bodyText": {
              "content": "Playing at 2x speed"
            }
          }
        },
        "showPlaybackRateUpsellPanelCommand": {
          "clickTrackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
          "commandMetadata": {
            "interactionLoggingCommandMetadata": {
              "screenVisualElement": "…"
            }
          },
          "showDialogCommand": {
            "panelLoadingStrategy": {
              "requestTemplate": "…",
              "screenVe": 214295
            }
          }
        }
      }
    },
    "onResponseReceivedEndpoints": [
      {
        "clickTrackingParams": "CAAQg2ciEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
        "loadMarkersCommand": {
          "visibleOnLoadKeys": [
            "EgpIRUFUU0VFS0VSIJICKAE%3D"
          ],
          "entityKeys": [
            "EgpIRUFUU0VFS0VSIJICKAE%3D"
          ]
        }
      }
    ],
    "engagementPanels": [
      {
        "engagementPanelSectionListRenderer": {
          "panelIdentifier": "engagement-panel-comments-section",
          "header": {
            "engagementPanelTitleHeaderRenderer": {
              "title": "…",
              "contextualInfo": "…",
              "menu": "…",
              "visibilityButton": "…",
              "trackingParams": "CCsQ040EGAEiEwjx5dic1d-VAxXhHFcBHWu_GRM="
            }
          },
          "content": {
            "sectionListRenderer": {
              "contents": "…",
              "trackingParams": "CCwQui8iEwjx5dic1d-VAxXhHFcBHWu_GRM="
            }
          },
          "veType": 76278,
          "targetId": "engagement-panel-comments-section",
          "visibility": "ENGAGEMENT_PANEL_VISIBILITY_HIDDEN",
          "loggingDirectives": {
            "trackingParams": "CCsQ040EGAEiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "visibility": {
              "types": "12"
            }
          }
        }
      },
      {
        "engagementPanelSectionListRenderer": {
          "content": {
            "adsEngagementPanelContentRenderer": {
              "hack": true
            }
          },
          "targetId": "engagement-panel-ads",
          "visibility": "ENGAGEMENT_PANEL_VISIBILITY_HIDDEN",
          "loggingDirectives": {
            "trackingParams": "CCoQ040EGAIiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "visibility": {
              "types": "12"
            }
          }
        }
      },
      {
        "_more_items": 4
      }
    ],
    "topbar": {
      "desktopTopbarRenderer": {
        "logo": {
          "topbarLogoRenderer": {
            "iconImage": {
              "iconType": "YOUTUBE_LOGO"
            },
            "tooltipText": {
              "runs": "…"
            },
            "endpoint": {
              "clickTrackingParams": "CBIQsV4iEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
              "commandMetadata": "…",
              "browseEndpoint": "…"
            },
            "trackingParams": "CBIQsV4iEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "overrideEntityKey": "EgZ0b3BiYXIg9QEoAQ%3D%3D"
          }
        },
        "searchbox": {
          "fusionSearchboxRenderer": {
            "icon": {
              "iconType": "SEARCH"
            },
            "placeholderText": {
              "runs": "…"
            },
            "config": {
              "webSearchboxConfig": "…"
            },
            "trackingParams": "CA4Q7VAiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "searchEndpoint": {
              "clickTrackingParams": "CA4Q7VAiEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
              "commandMetadata": "…",
              "searchEndpoint": "…"
            },
            "clearButton": {
              "buttonRenderer": "…"
            },
            "showImageSourceDialog": {
              "clickTrackingParams": "CA4Q7VAiEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
              "showDialogCommand": "…"
            },
            "disableAiAppearance": true
          }
        },
        "trackingParams": "CAIQq6wBIhMI8eXYnNXflQMV4RxXAR1rvxkT",
        "topbarButtons": [
          {
            "topbarMenuButtonRenderer": {
              "icon": "…",
              "menuRequest": "…",
              "trackingParams": "CAwQ_qsBGAAiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
              "accessibility": "…",
              "tooltip": "Settings",
              "style": "STYLE_DEFAULT"
            }
          },
          {
            "buttonRenderer": {
              "style": "STYLE_SUGGESTIVE",
              "size": "SIZE_SMALL",
              "text": "…",
              "icon": "…",
              "navigationEndpoint": "…",
              "trackingParams": "CAsQ1IAEGAEiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
              "targetId": "topbar-signin"
            }
          }
        ],
        "hotkeyDialog": {
          "hotkeyDialogRenderer": {
            "title": {
              "runs": "…"
            },
            "sections": [
              "…",
              "…",
              {
                "_more_items": 2
              }
            ],
            "dismissButton": {
              "buttonRenderer": "…"
            },
            "trackingParams": "CAkQteYDIhMI8eXYnNXflQMV4RxXAR1rvxkT"
          }
        },
        "backButton": {
          "buttonRenderer": {
            "trackingParams": "CAgQvIYDIhMI8eXYnNXflQMV4RxXAR1rvxkT",
            "command": {
              "clickTrackingParams": "CAgQvIYDIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "forwardButton": {
          "buttonRenderer": {
            "trackingParams": "CAcQvYYDIhMI8eXYnNXflQMV4RxXAR1rvxkT",
            "command": {
              "clickTrackingParams": "CAcQvYYDIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "a11ySkipNavigationButton": {
          "buttonRenderer": {
            "style": "STYLE_DEFAULT",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "text": {
              "runs": "…"
            },
            "trackingParams": "CAYQ8FsiEwjx5dic1d-VAxXhHFcBHWu_GRM=",
            "command": {
              "clickTrackingParams": "CAYQ8FsiEwjx5dic1d-VAxXhHFcBHWu_GRPKAQRetfVv",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            }
          }
        },
        "voiceSearchButton": {
          "buttonRenderer": {
            "style": "STYLE_DEFAULT",
            "size": "SIZE_DEFAULT",
            "isDisabled": false,
            "serviceEndpoint": {
              "clickTrackingParams": "CAMQ7a8FIhMI8eXYnNXflQMV4RxXAR1rvxkTygEEXrX1bw==",
              "commandMetadata": "…",
              "signalServiceEndpoint": "…"
            },
            "icon": {
              "iconType": "MICROPHONE_ON"
            },
            "tooltip": "Search with your voice",
            "trackingParams": "CAMQ7a8FIhMI8eXYnNXflQMV4RxXAR1rvxkT",
            "accessibilityData": {
              "accessibilityData": "…"
            }
          }
        }
      }
    },
    "pageVisualEffects": [
      {
        "cinematicContainerRenderer": {
          "gradientColorConfig": [
            {
              "darkThemeColor": 2566914048,
              "startLocation": 0
            },
            {
              "darkThemeColor": 2130706432
            },
            {
              "_more_items": 1
            }
          ],
          "presentationStyle": "CINEMATIC_CONTAINER_PRESENTATION_STYLE_DYNAMIC_BLURRED",
          "config": {
            "lightThemeBackgroundColor": 4278190080,
            "darkThemeBackgroundColor": 4278190080,
            "animationConfig": {
              "minImageUpdateIntervalMs": 5000,
              "crossfadeDurationMs": 5000,
              "crossfadeStartOffset": 1,
              "maxFrameRate": 30
            },
            "colorSourceSizeMultiplier": 2.5,
            "applyClientImageBlur": true,
            "bottomColorSourceHeightMultiplier": 0.67,
            "maxBottomColorSourceHeight": 260,
            "colorSourceWidthMultiplier": 1.5,
            "colorSourceHeightMultiplier": 2,
            "blurStrength": 5,
            "watchFullscreenConfig": {
              "colorSourceWidthMultiplier": 2,
              "colorSourceHeightMultiplier": 2,
              "scrimWidthMultiplier": 2.5,
              "scrimHeightMultiplier": 2.5,
              "flatScrimColor": 2566914048
            },
            "enableInLightTheme": true
          }
        }
      }
    ],
    "microformat": {
      "microformatDataRenderer": {
        "videoDetails": {
          "comments": [
            {
              "@type": "https://schema.org/Comment",
              "dateCreated": "2026-04-14T12:31:41-07:00",
              "text": "Life was good",
              "author": "…",
              "upvoteCount": 15183
            }
          ]
        }
      }
    },
    "frameworkUpdates": {
      "entityBatchUpdate": {
        "mutations": [
          {
            "entityKey": "EgpIRUFUU0VFS0VSIJICKAE%3D",
            "type": "ENTITY_MUTATION_TYPE_REPLACE",
            "payload": {
              "macroMarkersListEntity": "…"
            }
          },
          {
            "entityKey": "EgZ0b3BiYXIg9QEoAQ%3D%3D",
            "type": "ENTITY_MUTATION_TYPE_DELETE",
            "options": {
              "persistenceOption": "ENTITY_PERSISTENCE_OPTION_INMEMORY_AND_PERSIST"
            }
          },
          {
            "_more_items": 3
          }
        ],
        "timestamp": {
          "seconds": "1784495890",
          "nanos": 139171382
        }
      }
    }
  }
}

動画で作業を続ける

関連するメソッドでは、同じオブジェクトを別の識別子で解決したり、詳細を開いたり、集計ビューに切り替えたりできます。

次のステップ

評価を続ける

このドキュメントを最初の判断材料とし、継続的な利用のためにエンドポイントを接続する前に、料金、プラットフォームのカバー範囲、連携ルールを確認してください。

YouTube のプラットフォームページを開く

実装の前に、関連するエンティティ、API メソッドのグループ、関連ドキュメントを比較してください。

プラットフォームページを開く

API メソッドの料金を比較する

利用を拡大する前に、公開料金表でこのメソッドの位置付けを確認してください。

料金を見る

連携ルールを確認する

入門ドキュメントで、認証、バージョン、再試行、テストと本番の違いを確認してください。

ドキュメントを開く

よくある質問

チームが実装前に尋ねる質問

これらの回答を参考に、この API メソッドがワークフロー、バージョンの選択、導入計画に合うかどうかを判断してください。

この YouTube API メソッドはどのようなデータを返しますか？

このメソッドは動画に対して「動画 ID による詳細」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

V1 と V2 のどちらを選ぶべきですか？

新しい連携では、正規化された構造を提供する V2 を選んでください。V1 は、既にプラットフォーム固有の形式を処理しているクライアントとの互換性のためにのみ使用してください。

最初のリクエストには何が必要ですか？

API キーを作成し、リクエストヘッダーで送信し、表の必須パラメーターを指定してください。コード例には、正しいパスとリクエスト構造が既に含まれています。

YouTube API: 動画 — 動画 ID による詳細

この API メソッドで構築できるもの

このエンドポイントが役立つこと

使用に適した場面

主なユースケース

レコードのエンリッチメント

データの検証

分析の準備

レスポンスのバージョン

共通する点

バージョン間で異なる点

メソッドの呼び出し方

入力パラメーター

バージョン別のリクエストパス

コード例

バージョン別のリクエストパス

コード例

バージョン別のライブレスポンス

V2 レスポンスの JSON

V1 レスポンスの JSON

動画 で作業を続ける

動画: 動画 ID によるコメント

動画: 動画 ID による関連コンテンツ

評価を続ける

YouTube のプラットフォームページを開く

API メソッドの料金を比較する

連携ルールを確認する

チームが実装前に尋ねる質問

動画で作業を続ける