Bing Webmaster Tools API surface
Transcribed from Microsoft's IWebmasterApi interface reference and each method's
definition page, fetched 2026-08-25. The interface has 62 methods. Exactly three are
marked Obsolete by Microsoft and are documented but deliberately not exposed, leaving
59 supported methods. HTTP verbs come from each method's WebGet or WebInvoke
attribute. R/W is this project's safety classification; FetchUrl is a write because it
requests a crawl and consumes quota.
Primary source: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.iwebmasterapi?view=bing-webmaster-dotnet
| Method | Params | HTTP | R/W | Group |
|---|---|---|---|---|
GetUserSites | — | GET | R | Sites |
GetSiteRoles | siteUrl, includeAllSubdomains | GET | R | Sites |
GetSiteMoves | siteUrl | GET | R | Sites |
AddSite | siteUrl | POST | W | Sites |
RemoveSite | siteUrl | POST | W | Sites |
VerifySite | siteUrl | POST | W | Sites |
AddSiteRoles | siteUrl, delegatedUrl, userEmail, authenticationCode, isAdministrator, isReadOnly | POST | W | Sites |
RemoveSiteRole | siteUrl, siteRole: SiteRoles | POST | W | Sites |
SubmitSiteMove | siteUrl, settings: SiteMoveSettings | POST | W | Sites |
GetQueryStats | siteUrl | GET | R | Traffic |
GetQueryTrafficStats | siteUrl, query | GET | R | Traffic |
GetQueryPageStats | siteUrl, query | GET | R | Traffic |
GetQueryPageDetailStats | siteUrl, query, page | GET | R | Traffic |
GetPageStats | siteUrl | GET | R | Traffic |
GetPageQueryStats | siteUrl, page | GET | R | Traffic |
GetRankAndTrafficStats | siteUrl | GET | R | Traffic |
GetUrlInfo | siteUrl, url | GET | R | Crawl |
GetUrlTrafficInfo | siteUrl, url | GET | R | Crawl |
GetChildrenUrlInfo | siteUrl, url, page, filterProperties: FilterProperties | POST | R | Crawl |
GetChildrenUrlTrafficInfo | siteUrl, url, page | GET | R | Crawl |
GetCrawlStats | siteUrl | GET | R | Crawl |
GetCrawlIssues | siteUrl | GET | R | Crawl |
GetCrawlSettings | siteUrl | GET | R | Crawl |
GetFetchedUrls | siteUrl | GET | R | Crawl |
GetFetchedUrlDetails | siteUrl, url | GET | R | Crawl |
SaveCrawlSettings | siteUrl, crawlSettings: CrawlSettings | POST | W | Crawl |
FetchUrl | siteUrl, url | POST | W | Crawl |
GetUrlSubmissionQuota | siteUrl | GET | R | Submission |
SubmitUrl | siteUrl, url | POST | W | Submission |
SubmitUrlBatch | siteUrl, urlList | POST | W | Submission |
GetContentSubmissionQuota | siteUrl | GET | R | Content submission |
SubmitContent | siteUrl, url, httpMessage, structuredData, dynamicServing | POST | W | Content submission |
GetFeeds | siteUrl | GET | R | Sitemaps |
GetFeedDetails | siteUrl, feedUrl | GET | R | Sitemaps |
SubmitFeed | siteUrl, feedUrl | POST | W | Sitemaps |
RemoveFeed | siteUrl, feedUrl | POST | W | Sitemaps |
GetBlockedUrls | siteUrl | GET | R | URL blocking |
AddBlockedUrl | siteUrl, blockedUrl: BlockedUrl | POST | W | URL blocking |
RemoveBlockedUrl | siteUrl, blockedUrl: BlockedUrl | POST | W | URL blocking |
GetQueryParameters | siteUrl | GET | R | Query parameters |
AddQueryParameter | siteUrl, queryParameter | POST | W | Query parameters |
RemoveQueryParameter | siteUrl, queryParameter | POST | W | Query parameters |
EnableDisableQueryParameter | siteUrl, queryParameter, isEnabled | POST | W | Query parameters |
GetCountryRegionSettings | siteUrl | GET | R | Geo targeting |
AddCountryRegionSettings | siteUrl, settings: CountryRegionSettings | POST | W | Geo targeting |
RemoveCountryRegionSettings | siteUrl, settings: CountryRegionSettings | POST | W | Geo targeting |
GetActivePagePreviewBlocks | siteUrl | GET | R | Page preview blocks |
AddPagePreviewBlock | siteUrl, url, reason: BlockReason | POST | W | Page preview blocks |
RemovePagePreviewBlock | siteUrl, url | POST | W | Page preview blocks |
GetDeepLinkBlocks | siteUrl | GET | R | Deep link blocks |
AddDeepLinkBlock | siteUrl, market, searchUrl, deepLinkUrl | POST | W | Deep link blocks |
RemoveDeepLinkBlock | siteUrl, market, searchUrl, deepLinkUrl | POST | W | Deep link blocks |
GetLinkCounts | siteUrl, page | GET | R | Inbound links |
GetUrlLinks | siteUrl, link, page | GET | R | Inbound links |
GetConnectedPages | siteUrl | GET | R | Inbound links |
AddConnectedPage | siteUrl, masterUrl | POST | W | Inbound links |
GetKeyword | q, country, language, startDate, endDate | GET | R | Keywords |
GetKeywordStats | q, country, language | GET | R | Keywords |
GetRelatedKeywords | q, country, language, startDate, endDate | GET | R | Keywords |
GetDeepLinkAlgoUrls | siteUrl | GET | R | Deep links obsolete |
GetDeepLink | siteUrl, url | GET | R | Deep links obsolete |
UpdateDeepLink | siteUrl, algoUrl, deepLink, weight | POST | W | Deep links obsolete |
Deliberate exclusions
GetDeepLinkAlgoUrls— Excluded: Microsoft marks this methodObsolete.GetDeepLink— Excluded: Microsoft marks this methodObsolete.UpdateDeepLink— Excluded: Microsoft marks this methodObsolete.
Verified complex request types
The exact serialized property names below come from the linked Microsoft type and property pages. Enum-valued properties are represented by their JSON numeric value; callers must not invent enum names.
BlockedUrl:Date,DaysToExpire,EntityType,RequestType,Url.CrawlSettings:CrawlBoostAvailable,CrawlBoostEnabled,CrawlRate.FilterProperties:CrawlDateFilter,DiscoveredDateFilter,DocFlagsFilters,HttpCodeFilters.SiteMoveSettings:Date,MoveScope,MoveType,SourceUrl,TargetUrl.CountryRegionSettings:Date,TwoLetterIsoCountryCode,Type,Url.SiteRoles:Date,DelegatedCode,DelegatedCodeOwnerEmail,DelegatorEmail,Email,Expired,Role,Site,VerificationSite.
SubmitContent takes an RFC-style HTTP response and structured data as base64 strings;
dynamicServing is an integer from 0 through 5. SubmitUrlBatch has a documented
per-call cap of 500 and must also fit the live quota returned by
GetUrlSubmissionQuota. Microsoft documents a 10 MB uncompressed content payload limit
per SubmitContent request; the combined decoded httpMessage and structuredData
must fit it.
Verified response types
Site(returned byGetUserSites):AuthenticationCode,DnsVerificationCode,IsVerified,Url. Source: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.site?view=bing-webmaster-dotnet, fetched 2026-09-02. The first two are the ownership proofs a site must publish in its verification file or meta tag and in a DNS TXT record; anyone holding one can claim the site in another Bing account.SiteRoles.DelegatedCodeis the same kind of value — Microsoft'sAddSiteRolestakes it asauthenticationCode. All three are redacted in every response this project returns; seedocs/operations.md.UrlWithCrawlIssues(returned byGetCrawlIssues):HttpCode(Int32),InLinks,Issues,Url. Source: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.urlwithcrawlissues?view=bing-webmaster-dotnet, fetched 2026-09-01.UrlWithCrawlIssues.CrawlIssuesis a[Flags]enum, soIssuesis a bitmask and one URL can carry several:None0,Code3011,Code3022,Code4xx4,Code5xx8,BlockedByRobotsTxt16,ContainsMalware32,ImportantUrlBlockedByRobotsTxt64,DnsErrors128,TimeOutErrors256. Source: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.urlwithcrawlissues.crawlissues?view=bing-webmaster-dotnet, fetched 2026-09-01. There is nonoindexmember and no separate 404 or 403 member; the exact status code is theHttpCodefield, not a flag. This project therefore deriveshttp_404andhttp_403fromHttpCodeon rows Bing itself flaggedCode4xx, and derives nonoindexcategory from anything.UrlInfo(returned byGetUrlInfo):AnchorCount,DiscoveryDate,DocumentSize,HttpStatus,IsPage,LastCrawledDate,TotalChildUrlCount,Url. Source: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.urlinfo?view=bing-webmaster-dotnet, fetched 2026-09-01. There is no indexing-status, robots-directive or content-changed property.HttpStatusis anInt32and Microsoft documents no sentinel for it. Observed on a live account, 2026-09-02:GetUrlInforeturnedHttpStatus: 0withIsPage: trueand aLastCrawledDatefor a URL that answers 404 today. Zero is not a status code, so this project reads it as "Bing reported no status" and labels the rowhttp_status_reported: falserather than passing a number a caller would read as one. Nothing is derived: the rawHttpStatusis kept, and the real status is not fetched.- Empty responses, observed on a live account, 2026-09-02. For the same site and in
the same minute,
GetLinkCountsreturned{"Links": [], "TotalPages": 0},GetCrawlIssuesreturned[]andGetFetchedUrlsreturned[], whileGetCrawlStatsreportedInLinks: 1700,CrawlErrors: 4andCode4xx: 1. Microsoft documents no way to distinguish "nothing to report" from "not reported"; there is no status field, no coverage flag and no error. The reads therefore label an empty response instead of presenting it as a measurement. QueryStats(returned byGetQueryStats):AvgClickPosition,AvgImpressionPosition,Clicks,Date,Impressions,Query.RankAndTrafficStats(returned byGetRankAndTrafficStats):Clicks,Date,Impressions. Sources: https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.querystats?view=bing-webmaster-dotnet and https://learn.microsoft.com/en-us/dotnet/api/microsoft.bing.webmaster.api.interfaces.rankandtrafficstats?view=bing-webmaster-dotnet, fetched 2026-09-01. Bing returns no CTR field; a click-through rate isClicks / Impressions, computed by the caller.
Microsoft's AddSiteRoles JSON example pairs siteUrl: http://example.com with
delegatedUrl: http://host1.example.com. The delegated URL is therefore validated as
absolute but is not restricted to the site's exact host.
Edit on GitHub · 2026-09-02