seo/
youtube-serp

選んだ国と言語でYouTubeが検索語に対して表示する動画を順位どおりに返し、各動画のタイトル、チャンネル、再生回数、長さ、サムネイル、公開日を確認できます。

YouTube Rank Tracker API

順位どおり
順位どおりの動画
チャンネルと再生回数
国と言語を指定
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

YouTube Rank Tracker

YouTubeの検索順位とは、特定の国と言語でYouTubeが検索語に対して表示する動画の並びのことで、人々が調べるトピックでどの動画が見つけられるかを左右します。狙ったキーワードで順位を追えば、チャンネルの動画がどこに入っているか、市場ごとにどのチャンネルがトピックを押さえているか、上位動画がどれだけ新しくどれだけ長いか、結果が手薄で狙う価値のあるキーワードはどれかがわかります。

YouTube Rank Tracker API の主な機能

  • 順位どおりの動画行の並びは検索語に対するYouTubeの検索順で、各行は動画1本です。動画 id、視聴用の url、text にタイトルが入ります。
  • 各動画のチャンネルauthor にチャンネルの id、名前、url、アイコンが入り、順位をチャンネル単位でまとめられます。
  • 再生回数、長さ、公開日metrics.views_count、duration_seconds、published_at で、上位動画の人気、長さ、新しさがわかります。
  • すべての結果にサムネイルmedia に動画のサムネイルが入り、検索結果のビジュアルレポートにそのまま使えます。
  • 市場ごとの順位検索の国と言語を設定し、results_limit で1〜200本の動画を読み取ります。

YouTube Rank Tracker API のパラメータ

パラメータ必須説明
query必須YouTubeで検索するキーワード(例:crm tutorial)。
location_code任意検索市場のロケーションコード。既定は2840(米国)です。
location_name任意location_code の代わりに使う市場名。指定すると location_code より優先されます。
language_code任意検索の言語コード。既定は en です。
language任意language_code の代わりに使う言語名。指定すると language_code より優先されます。
results_limit任意取得する動画の上限。1〜200、既定は20です。

YouTube Rank Tracker API の使い方

検索語を送信し、順位どおりに動画ごとに1行で読み取ります。

  1. {"query": "crm tutorial", "location_code": 2840, "language_code": "en", "results_limit": 20} を /v1/seo/youtube-serp に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から順に動画を読み取り、has_more が true の間は results.next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/seo/youtube-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"crm tutorial","location_code":2840,"language_code":"en","results_limit":20}'

YouTube Rank Tracker API の主なユースケース

  • 狙ったキーワードで自社動画の順位を追跡: キーワードを定期的に検索し、author の id が自社チャンネルである動画の位置を記録します。
  • トピックを押さえているチャンネルを把握: 一連のキーワードの結果で各 author が登場する回数を数え、市場ごとにトピックを支配するチャンネルを洗い出します。
  • 狙う価値のあるキーワードを見つける: 上位動画の views_count が少ない、または published_at が古い検索語を探します。質の高い新しい動画が上がれる余地がある目印です。
  • 動画の長さと形式を計画: 上位結果の duration_seconds を比べ、そのトピックでYouTubeがどの長さの動画を評価しているかを確認します。

YouTube Rank Tracker API 活用のヒント

  • 順位を保存するときは、返された並びでの各動画の位置を検索語、市場、日付とあわせて記録しましょう。並び順がそのまま順位です。
  • 自社の動画を照合するときは、変わることのあるチャンネル名ではなく author.id で比べましょう。
  • 最初の画面に出る結果だけ追うなら results_limit は20前後で十分です。動画1本ごとに0.5クレジットかかります。

YouTube Rank Tracker API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Keywords for Site API — 1つのWebサイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
  • Google Autocomplete API — 検索語の書き出しに対してGoogleが示すサジェストを、Googleの表示順のまま、国と言語を選んで集めます。

他のプラットフォームを見る

SEOのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

YouTube Rank Tracker API — よくある質問

YouTube Rank Tracker APIは、選んだ国と言語でYouTubeが検索語に対して表示する動画を順位どおりに返すAPIで、各動画のタイトル、チャンネル、再生回数、長さ、サムネイル、公開日を含みます。

はい。各行は検索順位どおりに並んだ動画で、その動画を公開したチャンネルは author に入っています。

results_limit は1〜200で、既定は20です。

返された動画1本ごとに0.5クレジットです。