Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon What is the difference between 'phrase_all' and 'phrase_this' in the Keyword Overview API


What is the difference between 'phrase_all' and 'phrase_this' in the Keyword Overview API


the main difference between the `phrase_all` and `phrase_this` API endpoints for the Keyword Overview report is:

1. phrase_all:
- This endpoint retrieves the Keyword Overview data for a given keyword across all available regional databases.
- It returns the keyword metrics (search volume, CPC, competition, etc.) aggregated across all the databases.
- This is useful when you want to get a global view of the keyword's performance.

2. phrase_this:
- This endpoint retrieves the Keyword Overview data for a given keyword, but for a specific regional database.
- You need to specify the `database` parameter to indicate which regional database you want the data for (e.g. `database=us`).
- This allows you to get more granular, region-specific data for the keyword.

In summary:

- `phrase_all` gives you the Keyword Overview data aggregated across all regions.
- `phrase_this` allows you to retrieve the Keyword Overview for a specific regional database.

The choice between the two depends on whether you need a global or a more localized view of the keyword data. If you're targeting a specific market, using the `phrase_this` endpoint with the appropriate regional database would be more relevant. If you want an overall, cross-regional perspective, the `phrase_all` endpoint would be more suitable.

Both endpoints support additional parameters like `display_limit` and `export_columns` to customize the data returned in the response.

Citations:
[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/