検索結果に基づくと、キーワード概要レポートの `phrase_all` と `phrase_this` API エンドポイントの主な違いは次のとおりです。
1. phrase_all:
- このエンドポイントは、利用可能なすべての地域データベースから特定のキーワードのキーワード概要データを取得します。
- すべてのデータベースにわたって集計されたキーワード指標 (検索ボリューム、CPC、競合など) を返します。
- これは、キーワードの掲載結果を全体的に把握したい場合に便利です。
2. phrase_this:
- このエンドポイントは、特定の地域データベースを対象として、指定されたキーワードのキーワード概要データを取得します。
- データが必要な地域データベースを示すには、`database` パラメータを指定する必要があります (例: `database=us`)。
- これにより、キーワードのより詳細な地域固有のデータを取得できます。
要約すれば:
- `phrase_all` は、すべての地域にわたって集計されたキーワード概要データを提供します。
- `phrase_this` を使用すると、特定の地域データベースのキーワード概要を取得できます。
この 2 つのどちらを選択するかは、キーワード データのグローバルなビューが必要か、それともよりローカライズされたビューが必要かによって決まります。特定の市場をターゲットにしている場合は、適切な地域データベースで「phrase_this」エンドポイントを使用する方が適切です。全体的で地域を超えた視点が必要な場合は、「phrase_all」エンドポイントの方が適しています。
どちらのエンドポイントも、応答で返されるデータをカスタマイズするための「display_limit」や「export_columns」などの追加パラメータをサポートしています。
引用:[1] https://www.semrush.com/kb/257-keyword-overview
[2] https://www.semrush.com/kb/972-api-reports
[3] https://developer.semrush.com/api/v3/analytics/keyword-reports/
[4] https://www.semrush.com/features/keyword-research/
[5] https://www.semrush.com/analytics/keywordoverview/