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 の使い方
ドメインを市場とともに送信し、タスクが完了したら概況の行を読み取ります。
- {"target": "notion.so", "location_code": 2840, "language_code": "en"} を /v1/seo/domain-overview に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 を使います。
関連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検索からの月間訪問数とキーワード数を、オーガニックと有料に分けて推定します。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API