YouTube API ドキュメント

YouTube API: 投稿 — ユーザー識別子で

特定の「ユーザー識別子で」操作で YouTube の 投稿 データを取得し、製品のワークフローに接続します。

識別子または入力パラメーターがわかっていて、1 つの予測可能な API 結果が必要な場合にこのメソッドを使用します。

メソッド GET
エンティティ 投稿
バージョン 2
このエンドポイントの機能

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

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

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

レスポンスには、投稿 の公開データと、次の API リクエストに必要なコンテキストが含まれます。

使用に適した場面

識別子または入力パラメーターがわかっていて、1 つの予測可能な API 結果が必要な場合にこのメソッドを使用します。

主なユースケース

ターゲットを絞った取得

より大きなコレクションを読み込むことなく、必要なオブジェクトだけを要求します。

製品のエンリッチメント

レコード、ワークフロー、社内ツールを YouTube API の結果で補完します。

リクエストのオーケストレーション

レスポンスを関連するメソッドや複数ステップのワークフローの入力として使用します。

利用できるバージョン

レスポンスのバージョン

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

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

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

共通する点

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

バージョン間で異なる点

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

使い方

メソッドの呼び出し方

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

入力パラメーター

共通パラメーター
パラメーター 必須 型 例 説明
user_identifier はい str mkbhd YouTube channel handle, username, or channel identifier. Example: mkbhd.
cursor いいえ str | None cursor-next-page 前のレスポンスで返された次のページのカーソル。最初のページでは省略します。

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

V2

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

GET /api/v2/youtube.com/posts/by-user-identifier

正規化された形式

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/posts/by-user-identifier" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_identifier=mkbhd' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'
レスポンス例

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

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

レスポンス例

V2 レスポンスの JSON

検証済みの例

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

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "user_identifier": "mkbhd"
  },
  "data": {
    "posts": {
      "count": 8,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
          "post_id": "UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
          "text": "Alright, it's that time: https://vote.mkbhd.com\n\nWelcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3 categories. Scientific winners revealed (I'll collect and re…",
          "hashtags": [],
          "emails": [],
          "published_time": "2 years ago (edited)",
          "is_edited": true,
          "vote_count": 11000,
          "comment_count": 1000,
          "links": [
            {
              "url": "https://vote.mkbhd.com/",
              "link_type": "website",
              "label": "https://vote.mkbhd.com",
              "channel_id": null,
              "video_id": null
            }
          ],
          "attachment_type": "image",
          "attached_video": null,
          "image_count": 1,
          "images": [
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            }
          ]
        },
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "url": "https://www.youtube.com/post/Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok",
          "post_id": "Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok",
          "text": "Introducing a new colorway and updated design: 251.1. Now in matte black. (Plus a new water repellent ripstop mesh and a little touch of silver reflective detail for the winter)…",
          "hashtags": [],
          "emails": [],
          "published_time": "2 years ago",
          "is_edited": false,
          "vote_count": 31000,
          "comment_count": 1300,
          "links": [
            {
              "url": "https://atoms.com/products/mkbhd251-1",
              "link_type": "website",
              "label": "https://atoms.com/products/mkbhd251-1",
              "channel_id": null,
              "video_id": null
            }
          ],
          "attachment_type": "multi_image",
          "attached_video": null,
          "image_count": 4,
          "images": [
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            },
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "_more_items": 6
        }
      ]
    }
  }
}
次のステップ

評価を続ける

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

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

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

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

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

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

料金を見る

連携ルールを確認する

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

ドキュメントを開く
よくある質問

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

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

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

このメソッドは 投稿 に対して「ユーザー識別子で」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

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

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

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

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