get_keyword¶
Get market-wide impression data for a single keyword over a specific date range.
Parameters¶
| Name | Type | Required | Description |
|---|---|---|---|
query |
string | Yes | The keyword to look up |
country |
string | Yes | Country code (e.g. us, gb) |
language |
string | Yes | Language-country code (e.g. en-US, en-GB) |
start_date |
string | Yes | Start date in YYYY-MM-DD format |
end_date |
string | Yes | End date in YYYY-MM-DD format |
Response¶
{
"query": "blazor dependency injection",
"country": "us",
"language": "en-US",
"startDate": "2026-01-01",
"endDate": "2026-01-31",
"found": true,
"impressions": 2140,
"broadImpressions": 5830,
"queriedAt": "2026-02-21T19:00:00Z"
}
If Bing has no data for the keyword/period/market combination:
{
"query": "an extremely obscure phrase",
"country": "us",
"language": "en-US",
"startDate": "2026-01-01",
"endDate": "2026-01-31",
"found": false,
"impressions": 0,
"broadImpressions": 0,
"queriedAt": "2026-02-21T19:00:00Z"
}
Example Prompts¶
"How many Bing searches happened for 'blazor dependency injection' in the US last month?"
Notes¶
- Unlike most tools, this one does not take a
site_url-- it reflects overall Bing search volume for the term, not your site's specific ranking or traffic. found: falseis not an error -- it just means no data exists for that exact combination.- For a summed set of related terms instead of one exact keyword, see
get_related_keywords. For your own site's actual performance on this keyword, seeget_query_statsorget_query_traffic_stats.