YouTube Hashtag Search
YouTubeのハッシュタグフィードは、トピックタグに紐づく公開動画のコレクションで、タイトル、説明、チャンネル情報、サムネイル、再生時間、公開情報、表示中のエンゲージメントを持ちます。これらのレコードは、トピックのマッピング、キャンペーン参加状況の確認、ショートのサンプリング、コンテンツの比較分析に活用できます。
YouTube Hashtag Search API の主な機能
- ハッシュタグフィードからの発見動画やチャンネルのURLを指定しなくても、ハッシュタグに紐づく公開動画を見つけられます。
- 全コンテンツモードとショートモードcontent_type を all にすると表示中のハッシュタグフィードを、shorts にするとショートのみのサンプルを取得できます。
- 動画とチャンネルの文脈タイトル、説明、チャンネル情報、サムネイル、再生時間、公開情報、表示中の視聴回数・高評価数・コメント数を返します。
- 取得元ハッシュタグの保持保存される各レコードには、その動画結果に対して保持された正規化済みの取得元ハッシュタグが含まれます。
YouTube Hashtag Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
hashtags | 必須 | 空でないハッシュタグを1つ以上指定します。先頭の # は任意で、取得前に除去されます。 |
results_limit | 任意 | ハッシュタグごとに取得する動画の最大件数です。20〜2,000の範囲で指定し、デフォルトは100です。 |
content_type | 任意 | コンテンツモードです。all は表示中のハッシュタグフィード、shorts はショートのみの結果を返します。デフォルトは all です。 |
YouTube Hashtag Search API の使い方
確認したいトピックの範囲を表すタグを選び、サンプルを比較する必要がある場合は、コンテンツモードとタグごとの上限を統一してください。
- 空でないハッシュタグを1つ以上用意し(先頭の # は有無どちらでも可)、all または shorts を選択します。
- hashtags、results_limit、content_type を /v1/youtube/hashtag-search に POST します。
- 返された task_id を保存し、タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
- data.results.items から正規化された動画を読み取り、has_more が true の間は next_cursor を使って続きを取得します。
curl -X POST "https://api.socq.ai/v1/youtube/hashtag-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags":["#technology"],"results_limit":20,"content_type":"shorts"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueYouTube Hashtag Search API の主なユースケース
- キャンペーン参加状況の確認: ハッシュタグフィードのサンプル、動画の説明、チャンネル情報、表示中のエンゲージメントを使い、公開キャンペーンへの参加状況を確認します。
- ショートのトピックサンプリング: shorts を選択して、トピックタグに紐づくショート動画に絞ったサンプルを作成します。
- トピック別データセットの準備: 動画ID、URL、公開情報、チャンネルの文脈、指標、保持された取得元タグを組み合わせ、構造化された調査用データセットを作成します。
YouTube Hashtag Search API 活用のヒント
- #technology と technology で重複した取得処理が発生しないよう、送信前に入力リストを正規化してください。
- 重複する動画IDは1回だけ保存され、取得元ハッシュタグも1つしか保持されないため、重なり合うフィード間の帰属が重要な場合は1タスクにつき1つのハッシュタグを使用してください。
- results_limit はハッシュタグごとの上限として扱ってください。フィードが終わった場合や、対象となる動画が少ない場合は、それより早く取得が止まることがあります。
- フォーマットを比較する際は、all と shorts のサンプルを分けて扱い、混在したフィードがショート動画のサブセットを歪めないようにしてください。
- サムネイルや取得元のURLは、恒久的にダウンロードできるメディアとみなさず、参照として保存してください。
関連API
YouTube Hashtag Search API 以外に別の種類の公開YouTubeデータが必要な場合は、これらのAPIをご利用ください。
- YouTube Comments API — 公開コメント、投稿者、エンゲージメント、元の動画、会話の情報を取得します。
- YouTube Videos API — 既知の動画またはショートのURLから、メタデータ、サムネイル、再生時間、エンゲージメントを取得します。
- YouTube Shorts API — チャンネルごとに、公開ショート、サムネイル、再生時間、公開情報、エンゲージメントを取得します。
- YouTube Search API — キーワードで通常の公開動画を検索します。対応するメタデータのフィルターを指定できます。
- YouTube Channel Search API — キーワードでチャンネルを検索し、チャンネル名、チャンネル登録者数、アイコン、説明文の抜粋を返します。
- YouTube Shorts Search API — キーワードでショートを検索し、リンク、キャプション、視聴回数、縦長のサムネイルを返します。
- YouTube Channel Videos API
- YouTube Transcripts API
- YouTube Channels API
- YouTube Channel Live Videos API
- YouTube Comment Replies API
- YouTube Community Posts API
- YouTube Playlist Videos API
- YouTube Trending Shorts API
- YouTube Community Post API
- YouTube Community Post Comments API
- YouTube Related Videos API
- YouTube Search Suggestions API
- YouTube Email Finder API
- YouTube Trending Videos API