seo/
domain-overview

1つの国と言語について、ドメインのGoogle検索のオーガニック・有料の集計を取得し、ランクインキーワード数、月間トラフィックとその広告費、順位帯、順位変動を返します。

Domain Overview API

オーガニックと有料の集計
1〜100位の順位帯
国と言語で市場を指定
1リクエストあたり5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Domain Overview

ドメインの検索での存在感とは、1つの国と言語におけるGoogle検索結果への露出のことで、ランクインしているキーワード数、その順位から見込まれる月間訪問数、そのトラフィックを広告で得た場合の費用としてまとめられ、オーガニックと有料に分かれ、1位から100位までの順位帯と、新規・上昇・下降・圏外のランキング数に分けて示されます。これらの集計1行で競合の規模を測り、見込み客を検索での存在感で見極め、毎月保存すれば自社サイトの露出の推移も追えます。

Domain Overview API の主な機能

  • 1つのドメインを1つのGoogle市場でtarget にドメインを指定し、location と language で検索結果の国と言語を選びます(デフォルトは米国と英語)。行には location_code と language_code が繰り返し入るため、保存したスナップショットのラベルが失われません。
  • オーガニックと有料を同じ形式でorganic と paid はそれぞれ同じ集計項目を持つため、自然検索の順位と検索広告をフィールド単位で比較できます。
  • トラフィックとその広告価値keywords_count はランクインキーワード数、estimated_traffic はそれらがもたらす月間訪問数、estimated_traffic_cost はそのトラフィックをGoogle広告の単価で換算した米ドルの金額です。
  • 12の順位帯positions はランクインキーワードを pos_1、pos_2_3、pos_4_10 から pos_91_100 までの帯に分け、ドメインが1ページ目を取れているか、もっと下に沈んでいるかを示します。
  • 前回の更新以降の順位変動new_count、up_count、down_count、lost_count は、前回のデータ更新以降にランキングに入った、上昇した、下降した、圏外になったキーワードの数を示します。

Domain Overview API のパラメータ

パラメータ必須説明
target必須分析するドメインまたはサブドメインです(例:notion.so)。https:// と www. は取り除かれ、パスを含むURLは拒否されます。
location_code任意検索する国の数値コードです(例:米国は2840で、これがデフォルト)。これか location_name のどちらかを使います。
location_name任意location_code の代わりに使う国名です(例:United States)。両方を送る場合は同じ国を指している必要があります。
language_code任意en(デフォルト)のような言語コードです。選んだ国で利用できる言語のいずれかである必要があります。
language任意language_code の代わりに使う言語名です(例:English)。両方を送る場合は一致している必要があります。

Domain Overview API の使い方

ドメインを市場とともに送信し、タスクが完了したら概況の行を読み取ります。

  1. {"target": "notion.so", "location_code": 2840, "language_code": "en"} を /v1/seo/domain-overview に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から1行の概況を読み取ります。results.next_cursor が関係するのは has_more が true のときだけです。
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"notion.so","location_code":2840,"language_code":"en"}'

# One market per request, 5 credits.

Domain Overview API の主なユースケース

  • 競合の検索での存在感の把握: organic.keywords_count と organic.estimated_traffic を読み、競合がGoogle経由ですでに市場のどれだけに届いているかを確かめます。
  • 自社の検索露出の月次追跡: positions の各順位帯と、新規・上昇・下降・圏外の件数を毎月保存し、順位が1ページ目に近づいているかをグラフにします。
  • 代理店の見込み客の見極め: organic.estimated_traffic_cost を見込み客の検索トラフィックの価値を示す金額として使い、どのアカウントを追うべきかを判断します。
  • 検索広告の出稿有無の確認: paid.keywords_count と paid.estimated_traffic から、ドメインがその市場でGoogleの検索広告を出しているか、どれだけのトラフィックを得ているかがわかります。
  • 1つのサイトの国別比較: 同じドメインを location と language の設定を変えて送り、どの市場でもっとも強いかを確かめます。

Domain Overview API 活用のヒント

  • 英語が提供されていない国では、language_code か language を自分で設定してください。デフォルトの en は、その国が英語を扱っている場合にのみ受け付けられます。
  • 順位帯は重ならない別々の範囲なので、1ページ目のキーワード数を出すには pos_1、pos_2_3、pos_4_10 を合計してください。
  • 新規・上昇・下降・圏外の件数は、自分の前回のリクエストではなく前回のデータ更新からの変化として読み、各行を collected_at とともに保存して独自の履歴を作ってください。
  • ドメインのみを送信してください。サイト内の個々のページの数値が必要な場合は、ページごとの順位分布を返す Relevant Pages API を使います。

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

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Ranked Keywords API — ドメイン、サブドメイン、ページがランクインしているキーワードを、一致するURL、順位、検索指標、検索意図、元データの全要素とともに取得します。
  • Competitor Domains API — 1つの市場で、サイトと同じGoogleキーワードでランクインしているドメインを、共有キーワード数、平均順位、重複部分のトラフィック、検索の総合集計とともに見つけます。
  • Traffic Estimate API — 1つの市場で、最大1,000ドメインのGoogle検索からの月間訪問数とキーワード数を、オーガニックと有料に分けて推定します。

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

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

Domain Overview API — よくある質問

Domain Overview APIは、選んだ1つの国と言語におけるドメインのGoogle検索の集計を読み取るためのプログラムインターフェースです。オーガニックと有料のキーワード数、推定月間トラフィックとその広告費、順位帯ごとのランキング、新規・上昇・下降・圏外のキーワード数を返します。

検索からのアクセス数を調べられます。estimated_traffic は、選んだ市場のGoogle検索結果からドメインが得ると推定される月間訪問数で、オーガニックと有料に分けて返ります。

国は location_code または location_name で、言語は language_code または language で指定します。言語はその国で提供されているものである必要があり、指定しない場合は米国と英語が使われます。

同じトラフィックをGoogle広告で購入した場合の推定月額費用(米ドル)で、自然検索での露出を比較可能な金額に換算したものです。

1リクエストで扱うのは1つのドメインです。長いリストでトラフィックとキーワード数を比べるなら、一度に最大1,000ドメインを受け付ける Traffic Estimate API を使ってください。

1つの市場の1ドメインを対象に、1リクエストにつき固定5クレジットです。