youtube/
hashtag-search

1つ以上のハッシュタグから公開YouTube動画を探し、タイトル、チャンネル情報、サムネイル、再生時間、エンゲージメント、取得元タグの文脈を正規化レコードとして返します。

YouTube Hashtag Search API

ハッシュタグフィード
ショートで絞り込み
取得元タグ
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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. 空でないハッシュタグを1つ以上用意し(先頭の # は有無どちらでも可)、all または shorts を選択します。
  2. hashtags、results_limit、content_type を /v1/youtube/hashtag-search に POST します。
  3. 返された task_id を保存し、タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

YouTube Hashtag Search API の主なユースケース

  • キャンペーン参加状況の確認: ハッシュタグフィードのサンプル、動画の説明、チャンネル情報、表示中のエンゲージメントを使い、公開キャンペーンへの参加状況を確認します。
  • ショートのトピックサンプリング: shorts を選択して、トピックタグに紐づくショート動画に絞ったサンプルを作成します。
  • トピック別データセットの準備: 動画ID、URL、公開情報、チャンネルの文脈、指標、保持された取得元タグを組み合わせ、構造化された調査用データセットを作成します。

YouTube Hashtag Search API 活用のヒント

  • #technology と technology で重複した取得処理が発生しないよう、送信前に入力リストを正規化してください。
  • 重複する動画IDは1回だけ保存され、取得元ハッシュタグも1つしか保持されないため、重なり合うフィード間の帰属が重要な場合は1タスクにつき1つのハッシュタグを使用してください。
  • results_limit はハッシュタグごとの上限として扱ってください。フィードが終わった場合や、対象となる動画が少ない場合は、それより早く取得が止まることがあります。
  • フォーマットを比較する際は、all と shorts のサンプルを分けて扱い、混在したフィードがショート動画のサブセットを歪めないようにしてください。
  • サムネイルや取得元のURLは、恒久的にダウンロードできるメディアとみなさず、参照として保存してください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Hashtag Search API — よくある質問

YouTube Hashtag Search APIは、1つ以上のハッシュタグに紐づく公開動画を見つけるためのプログラムインターフェースです。正規化された動画とチャンネルのフィールド、サムネイル、再生時間、公開情報、表示中のエンゲージメント、保持された取得元ハッシュタグを返します。

technology や #technology のような文字列を、空でない配列で送信します。先頭の # は任意で、取得前に除去されます。

はい。content_type を shorts にするとショートのみの結果を取得できます。デフォルトの all のままにすると、表示中のハッシュタグフィードを取得します。

results_limit は送信したハッシュタグごとに個別に適用され、デフォルトは100で、20〜2,000の整数を指定できます。表示中のフィードや100ページの取得上限により、レコードが少なくなることがあります。

1つのタスク内で重複する動画IDやURLは1回だけ保存されます。保存されたレコードは取得元ハッシュタグを1つしか保持しないため、フィードの帰属を正確に把握したい場合は、ハッシュタグを別々のタスクで送信してください。

保存された正規化動画1件につき0.5クレジットで、基本料金はかかりません。リクエストの見積もりは results_limit(未指定の場合はデフォルトの100)にハッシュタグの数を掛けて算出され、最終的な使用量は実際に保存されたレコード数に基づきます。結果が空の場合、結果に対する課金は発生しません。