Bing Webmaster Tools

interface BingWebmasterConfig {
  apiKey:   string;   // From Bing Webmaster → User Settings → API Access
  siteUrl:  string;   // Exact URL as registered in Bing Webmaster (e.g. "https://acmeplumbing.com/")
}

integrations row:
  provider:   'bing_webmaster'
  api_key:    encrypt(apiKey)
  metadata:   { siteUrl }

class BingWebmasterTool {
  private baseUrl = 'https://ssl.bing.com/webmaster/api.svc/json';
 
  constructor(
    private apiKey:  string,
    private siteUrl: string,
  ) {}
 
  private params(extra: Record<string, string> = {}) {
    return { apikey: this.apiKey, ...extra };
  }
 
  async getQueryStats(options: {
    startDate: string;   // YYYY-MM-DD
    endDate:   string;
  }): Promise<BingQueryStat[]> {
    const response = await axios.get(`${this.baseUrl}/GetQueryStats`, {
      params: {
        ...this.params(),
        siteUrl:   this.siteUrl,
        startDate: options.startDate,
        endDate:   options.endDate,
      },
    });
    const data = response.data.d ?? response.data;
    return (data.QueryStats ?? []).map((row: any) => ({
      query:       row.Query,
      clicks:      row.Clicks,
      impressions: row.Impressions,
      ctr:         row.Ctr,
      avgPosition: row.AvgImpPosition,
    }));
  }
 
  async getPageStats(options: {
    startDate: string;
    endDate:   string;
    page?:     string;   // Filter to a specific URL; omit for all pages
  }): Promise<BingPageStat[]> {
    const params: any = {
      ...this.params(),
      siteUrl:   this.siteUrl,
      startDate: options.startDate,
      endDate:   options.endDate,
    };
    if (options.page) params.page = options.page;
 
    const response = await axios.get(`${this.baseUrl}/GetPageStats`, { params });
    const data = response.data.d ?? response.data;
    return (data.PageStats ?? []).map((row: any) => ({
      url:         row.Page,
      clicks:      row.Clicks,
      impressions: row.Impressions,
      ctr:         row.Ctr,
      avgPosition: row.AvgImpPosition,
    }));
  }
 
  async getCrawlStats(): Promise<BingCrawlStats> {
    const response = await axios.get(`${this.baseUrl}/GetCrawlStats`, {
      params: { ...this.params(), siteUrl: this.siteUrl },
    });
    const stats = response.data.d?.CrawlStats ?? response.data.CrawlStats ?? {};
    return {
      crawledUrls:    stats.CrawledUrls,
      inIndexUrls:    stats.InIndexUrls,
      blockedByRobots: stats.RobotsBlockedUrls,
      crawlErrors:    stats.CrawlErrors,
    };
  }
 
  async getSites(): Promise<{ url: string; verified: boolean }[]> {
    const response = await axios.get(`${this.baseUrl}/GetUserSites`, {
      params: this.params(),
    });
    const sites = response.data.d?.Sites ?? response.data.Sites ?? [];
    return sites.map((s: any) => ({
      url:      s.SiteUrl ?? s,
      verified: s.IsVerified ?? true,
    }));
  }
 
  async verify(): Promise<void> {
    const sites = await this.getSites();
    const match = sites.find(s => s.url === this.siteUrl);
    if (!match) throw new Error(`Site ${this.siteUrl} not found in Bing Webmaster Tools`);
  }
}