Bing Webmaster Tools
Query your own live Bing Webmaster Tools data (queries, pages, query and page pairs) through the RankParse API, for any query Bing reports, not only the ones you track.
The /v1/bing/* routes read the Bing Webmaster Tools API for the websites your connected Bing account has verified. Every call is a live request to Bing, so it covers any query or page Bing reports for the website, not only your tracked keywords. It is the Bing counterpart of Google Search Console and answers in the same shape, with the same filters, sorting and period comparison.
Bing data is not the same as the stored snapshots in Rank tracking. Rank tracking is a daily sync of your tracked keywords across engines. These routes read Bing directly for any query. Bing returns only its bounded top-query and top-page data, in its own date bins (typically weekly), so low-traffic queries are absent and a date range includes every bin dated inside it.
Operations
| Operation | Route | Calls Bing |
|---|---|---|
| List properties | GET /v1/bing/properties | Yes |
| Query search analytics | GET /v1/bing/search-analytics | Yes |
| Get URL info | GET /v1/bing/url-info | Yes |
| Get a segment | GET /v1/bing/segment | Yes |
| Get crawl health | GET /v1/bing/crawl | Yes |
| List inbound links | GET /v1/bing/links | Yes |
| List sitemaps | GET /v1/bing/sitemaps | Yes |
| Keyword research | GET /v1/bing/keyword-research | Yes |
List properties
The websites verified in your Bing Webmaster Tools account.
Query search analytics
Clicks, impressions, CTR and position by query, page, query and page pair, or by day.
Get URL info
Bing's index details and traffic for one page.
Get a segment
Traffic or index details for the pages under a directory.
Get crawl health
Crawl statistics and the pages Bing had trouble crawling.
List inbound links
The links Bing knows to your own pages.
List sitemaps
The sitemaps and feeds Bing has.
Keyword research
How often a keyword is searched on Bing, by country and language.
Before you call
Connect Bing Webmaster Tools
In the RankParse dashboard open Settings, Connections and connect Bing Webmaster Tools. Sign in with the Microsoft account that has the website verified. If the website is not in Bing Webmaster Tools yet, add it there first (Bing can import it from Google Search Console), then verify it.
List your properties
Call List properties to see the websites the connection can read. You can also pass a bare host such as example.com as site: it is matched to the website you have verified.
Query it
Call Query search analytics with site, startDate and endDate.
Authentication and cost
Send your API key in X-API-Key. These routes cost 0 credits and need a role that can read live provider data (owner, admin or member). The rate limit is 60 requests per minute per key. Bing publishes no quota of its own, so each workspace is also limited to 300 live Bing reads in any rolling 24 hours. Past that the call returns 429 bing_daily_cap_reached: do not retry, read the stored data with Get rankings instead.
Errors shared by every route
All errors use the standard shape { "error", "code", "message" }. See Errors.
| HTTP | Code | When |
|---|---|---|
| 400 | bing_not_connected | Bing Webmaster Tools is not connected. The message says where to connect it. |
| 400 | bing_data_not_ready | Bing has not made this data available yet, usually because the website was verified recently. |
| 400 | bing_request_rejected | Bing rejected the request: the page may be unknown to it, the website may not have this data yet, or the method may not be available for the account. Retrying the same request fails again. |
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 401 | bing_token_expired | The Bing connection needs to be reconnected, or Bing rejected it. |
| 403 | capability_missing | Your role is client. |
| 403 | bing_access_denied | Bing denied access to this website for the connected account. |
| 404 | bing_site_not_found | No verified website matches site. The response lists valid_properties. |
| 429 | rate_limited | More than 60 requests per minute for this key. |
| 429 | bing_quota_exceeded | Bing is rate limiting the account. Check Retry-After. |
| 429 | bing_daily_cap_reached | The workspace used its 300 live Bing reads for the last 24 hours. |
| 502 | bing_api_error | Bing failed in another way, or the token could not be refreshed (bing_token_refresh_failed). |
| 503 | token_refresh_in_progress | Another request was refreshing the token. Retry after Retry-After. |
| 504 | bing_upstream_timeout | Bing did not answer in time. Retry the same request. |
MCP tools
| Tool | Operation |
|---|---|
get_bing_properties | List properties |
get_bing_top_queries | Query search analytics with dimension=query |
get_bing_top_pages | The same with dimension=page |
get_bing_page_queries | The same with dimension=query_page and a page |
get_bing_query_pages | The same with dimension=query_page and a query |
get_bing_date_trends | The same with dimension=date, the website's daily trend |
get_bing_query_trend | The same with dimension=date and a filterQuery, one query's daily trend |
get_bing_url_info | Get URL info |
get_bing_segment | Get a segment |
get_bing_crawl_health | Get crawl health |
get_bing_inbound_links | List inbound links |
get_bing_sitemaps | List sitemaps |
get_bing_keyword_research | Keyword research |
The tools are on the API-key MCP endpoint and on the full OAuth server (scope workspace:read). See MCP Server.