Traffic Estimate
検索トラフィックの推定値とは、特定の国と言語でウェブサイトがGoogle検索結果から得る月間訪問数を数値にしたもので、ランクインしているキーワード数付きのオーガニック訪問数と、広告を出しているキーワード数付きの有料訪問数に分かれます。数百のドメインでこの4つの数値を並べれば、見込み客や提携先のリストを規模順に並べたり、アカウント情報を補完したり、カテゴリ全体の競合を横並びで比べたりできます。
Traffic Estimate API の主な機能
- 1回のリクエストで最大1,000ドメインtargets には最大1,000ドメインのリストを指定でき、各ドメインがドメインをキーにした1行として返ります。
- ドメインごとに4つの数値organic_traffic と organic_keywords_count は広告以外の検索からの訪問数と順位を、paid_traffic と paid_keywords_count は検索広告からの訪問数とキーワード数を測ります。
- バッチ全体で1つの市場location と language のパラメータで、リスト内のすべてのドメインに適用するGoogleの国と言語を設定します(デフォルトは米国と英語)。
Traffic Estimate API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
targets | 必須 | 推定する最大1000のドメインです(例:notion.so、figma.com)。1行に1つ、またはカンマ区切りで指定し、https:// と www. は取り除かれます。 |
location_code | 任意 | リスト内のすべてのドメインに適用するGoogleの国の数値コードです。デフォルトは米国の2840で、これか location_name のどちらかを使います。 |
location_name | 任意 | location_code の代わりに使う国名です(例:United States)。両方を送る場合は同じ国を指している必要があります。 |
language_code | 任意 | 検索市場の言語コードで、デフォルトは en です。選んだ国で利用できる言語である必要があります。 |
language | 任意 | language_code の代わりに使う言語名です(例:English)。両方を送る場合は一致している必要があります。 |
Traffic Estimate API の使い方
ドメインのリストを市場とともに送信し、ドメインごとに1行のトラフィックを読み取ります。
- {"targets": ["notion.so", "figma.com", "canva.com"], "location_code": 2840, "language_code": "en"} を /v1/seo/traffic-estimate に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から行を読み取り、has_more が true の間は results.next_cursor をたどります。長いドメインリストではこの手順が必要です。
curl -X POST "https://api.socq.ai/v1/seo/traffic-estimate" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"targets":["notion.so","figma.com","canva.com"],"location_code":2840,"language_code":"en"}'
# 3 credits per request plus 0.1 per domain in targets.Traffic Estimate API の主なユースケース
- 見込み客リストの検索トラフィック順の並べ替え: 営業や提携のリストを送信して organic_traffic で並べ替え、検索からのオーディエンスがもっとも大きいサイトを上位に置きます。
- CRMのアカウント情報の補完: 各アカウントのWebサイト欄に organic_traffic と organic_keywords_count を書き込み、営業担当が検索規模でアカウントを分類できるようにします。
- カテゴリ全体のベンチマーク: 市場のすべてのブランドを一度に推定して organic_traffic と organic_keywords_count を比べ、そのカテゴリの検索で誰がリードしているかを確かめます。
- リスト内の検索広告出稿者の発見: paid_keywords_count がゼロより大きい行を絞り込み、paid_traffic で順位付けして、すでにGoogleの検索広告を購入しているドメインを見つけます。
Traffic Estimate API 活用のヒント
- 送信前にリストを整えてください。ドメインのみ、またはサイトのルートだけを入れます。パスを含む項目や無効な名前が1つでもあると、リクエスト全体が拒否されます。
- example.com と www.example.com のような重複は送信前に削除してください。1行にまとめられますが、リストの各項目がドメイン単位の料金に数えられます。
- 行は targets と異なる順序で返ることがあるため、結果は位置ではなく domain フィールドで自分のリストと突き合わせてください。
- location と language はリクエスト内のすべてのドメインに適用されるため、国が混在するリストは市場ごとに分けて1リクエストずつ送ってください。
- 順位帯、トラフィックの価値、順位変動が必要な候補リストは、各ドメインについて Domain Overview API で追加調査してください。
関連API
Traffic Estimate API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。
- Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
- Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
- Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
- Domain Overview API — 選んだ国と言語で、1つのドメインのGoogle検索のオーガニック・有料の集計を、ランクインキーワード数、推定トラフィックとその広告費、順位帯、順位変動とともに取得します。
- Competitor Domains API — 1つの市場で、サイトと同じGoogleキーワードでランクインしているドメインを、共有キーワード数、平均順位、重複部分のトラフィック、検索の総合集計とともに見つけます。
- Domain Technologies API — ドメインから、ウェブサイトが使っている技術をカテゴリ、権威スコア、SNSプロフィール、公開されている連絡先とともに検出します。
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API