概要
API + MCPこのリクエストで regex フィルターを使用する場合、機能は限定的で、構文も他のリクエストとは異なります。ワイルドカードとしてアスタリスク(*)記号を使用します。
クエリパラメータ
手動で設定するタイムアウト時間(秒)です。
返す結果数です。
結果の並び替えに使用する列。使用可能な列IDはレスポンスのスキーマを参照してください。ただし、このエンドポイントでは order_by で volume_monthly はサポートされません。
フィルター式。次の列IDが認識されます(select パラメータで認識されるIDとは異なります)。
clicks: 対象キーワードで検索したときの検索結果に対する、月間平均クリック数。
type: integer nullable
cpc: クリック単価(CPC)は、キーワードの有料検索結果において、広告主が広告クリック1回あたりに支払う平均価格を示します(単位:米ドルセント)。
type: integer nullable
cps: 検索あたりのクリック数(CPS)は、検索ボリュームに対するクリックの割合です。これは、ある国で対象キーワードが検索された際に、平均して何件の異なる検索結果がクリックされたかを示します。
type: float nullable
difficulty (10 units): 100点満点の指標で、キーワードのオーガニック検索結果上位10件にランクインする難易度の推定値。
type: integer nullable
first_seen: 検索エンジンでキーワードの結果を最初に確認した日付。
type: datetime nullable
global_volume (10 units): 当社データベース内のすべての国における、対象キーワードの月間平均検索回数。
type: integer nullable
intents (10 units): ユーザーの検索クエリの意図を示します。オブジェクトのフィールド:informational、navigational、commercial、transactional、branded、local。すべてのフィールドの型は bool で、値は true または false です。
type: object nullable
keyword:
type: string
parent_topic: 親トピックは、より一般的なトピックをページで狙いながら、対象キーワードでもランクインできるかどうかを示します。親トピックを特定するために、対象キーワードで1位のページを取り、そのページに最も多くのトラフィックを送っているキーワードを抽出します。
type: string nullable
parent_volume (10 units): 親トピックの検索ボリューム。
type: integer nullable
serp_domain_rating_top10_min: DR がこの値以下のサイトでも、上位10件に少なくとも1つ順位がある必要があります。
type: float nullable
serp_domain_rating_top5_min: DR がこの値以下のサイトでも、上位5件に少なくとも1つ順位がある必要があります。
type: float nullable
serp_features: 検索結果ページ(SERP)に表示される、通常のオーガニック結果以外の強調表示(SERP機能)。
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"
serp_last_update: 検索エンジンでキーワードの結果を最後に確認した日付。
type: datetime nullable
traffic_potential (10 units): 対象キーワードで1位のページが、ランクインしているすべてのキーワードから獲得しているオーガニックトラフィックの合計。
type: integer nullable
volume (10 units): 最新の既知データ(直近12か月)に基づく、キーワードの月間平均検索数の推定値。
type: integer nullable
volume_desktop_pct: デスクトップ端末で行われたキーワード検索の割合。
type: float nullable
volume_mobile_pct: モバイル端末で行われたキーワード検索の割合。
type: float nullable
word_count:
type: integer
返すカラムのカンマ区切りリストです。有効なカラム識別子はレスポンスのスキーマを参照してください。
volume_monthly_history フィールドで過去の月別検索ボリュームを取得するための終了日(YYYY-MM-DD形式)。volume_monthly_history をリクエストした場合にのみ必須です。
volume_monthly_history フィールドで過去の月別検索ボリュームを取得するための開始日(YYYY-MM-DD形式)。volume_monthly_history をリクエストした場合にのみ必須です。
指定したターゲットURLのスコープ。
検索対象:ドメインまたはURL。
指定した target の順位に基づいてキーワードをフィルタリングします。
2文字の国コード(ISO 3166-1 alpha-2)。
[2024年8月5日付で非推奨]。
指標を表示するキーワードのカンマ区切りリスト。
指標を表示する既存のキーワードリストのID。
出力形式。
応答
対象キーワードで検索したときの検索結果に対する、月間平均クリック数。
クリック単価(CPC)は、キーワードの有料検索結果で広告がクリックされるごとに広告主が支払う平均価格を示します。単位は米ドルセントです。
検索あたりのクリック数(CPS)は、検索ボリュームに対するクリックの割合です。これは、ある国で対象キーワードが検索された際に、平均して何件の異なる検索結果がクリックされたかを示します。
(10 単位) あるキーワードでオーガニック検索結果の上位 10 位以内にランクインするのがどれだけ難しいかを、100 点満点で推定したものです。
検索エンジンでキーワードの結果を最初に確認した日付。
(10 units)当社データベース内のすべての国において、対象キーワードが月に平均何回検索されているかを示します。
(10 units) ユーザーの検索クエリの背後にある目的を示します。オブジェクトのフィールド: informational、navigational、commercial、transactional、branded または local。すべてのフィールドは bool 型で、取り得る値は true または false です。
親トピックは、ページでより一般的なトピックをターゲットにしながら、ターゲットキーワードでランクインできるかどうかを判断します。親トピックを特定するには、キーワードのランキング1位のページを取り上げ、そのページに最も多くのトラフィックを送っているキーワードを見つけます。
(10 units) 親トピックの検索ボリューム。
ターゲットキーワードを検索した人のうち、オーガニック結果と有料結果の両方をクリックした人の月間平均割合。
ターゲットキーワードを検索した人のうち、オーガニック結果のみをクリックした人の月間平均割合。
ターゲットキーワードを検索した人のうち、有料結果のみをクリックした人の月間平均割合。
検索エンジンの結果ページ(SERP)で表示される、従来のオーガニック結果ではない、より充実した結果のことです。
検索エンジンでキーワードの結果を最後に確認した日付。
(10 units) ターゲットキーワードでランキング 1 位のページが、ランクインしているすべてのキーワードから獲得しているオーガニックトラフィックの合計。
(10 units) キーワードの月間平均検索回数を、直近の判明している 12 か月間のデータから推計したものです。
キーワードの検索のうち、デスクトップデバイスで行われた割合。
キーワードの検索のうち、モバイルデバイスで行われた割合。
(10 units) 直近1か月間におけるキーワード検索回数の推定値。このフィールドは order_by パラメータに含められない場合があります。
(2 units per historical month, with a minimum of 50 units) volume_monthly_date_from および volume_monthly_date_to パラメータで設定した期間における、キーワードの過去の月間検索ボリューム推定値。