Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon How do I specify the regional database in the Keyword Overview API request


How do I specify the regional database in the Keyword Overview API request


here's how you can specify the regional database when making a Keyword Overview API request with SEMrush:

1. Use the `database` parameter: When making the Keyword Overview API request, you need to include the `database` parameter and specify the regional database you want to retrieve data for.

2. Available database options: The SEMrush API documentation lists the available regional database options that you can use, such as `us`, `uk`, `de`, `fr`, `es`, `it`, `ru`, `br`, `au`, `ca`, `mx`, `tr`, `in`, `jp`, `cn`, `kr`, `tw`, `th`, `vn`, `id`, `ph`, `my`, `sg`, `hk`, `ae`, `za`, `eg`, `sa`, `pl`, `nl`, `be`, `at`, `ch`, `se`, `no`, `dk`, `fi`, `ie`, `cz`, `hu`, `ro`, `gr`, `pt`, `ar`, `cl`, `co`, `pe`, `ec`, `bo`, `pa`, `cr`, `uy`, `do`, `gt`, `sv`, `hn`, `ni`, `py`, `cu`, `jm`, `tt`, `bz`, `gy`, `sr`, `gf`, `fk`, `gp`, `mq`, `aw`, `bs`, `bm`, `vg`, `ai`, `ms`, `kn`, `lc`, `dm`, `ag`, `tc`, `vc`, `pr`, `vi`, `gl`, `is`, `fo`, `ad`, `gi`, `li`, `lu`, `mc`, `sm`, `va`.

Here's an example of how to make a Keyword Overview API request for the keyword "seo" in the US database:


https://api.semrush.com/?type=phrase_this&key=YOUR_API_KEY&phrase=seo&database=us&export_columns=Ph,Nq,Cp,Co,Nr,Td

In this example, we're using the `type=phrase_this` parameter to retrieve the Keyword Overview for a single database, and we're specifying the `database=us` parameter to get the data for the US region.

You can replace `us` with any of the other available database codes from the list above to retrieve the Keyword Overview for a different region.

By specifying the regional database, you can get more accurate and relevant keyword data for your target markets when using the SEMrush API.

Citations:
[1] https://developer.semrush.com/api/v3/analytics/keyword-reports/
[2] https://www.semrush.com/kb/257-keyword-overview
[3] https://www.semrush.com/features/keyword-research/
[4] https://www.semrush.com/kb/972-api-reports
[5] https://www.semrush.com/analytics/keywordoverview/