Skip to content
One API for Agents
Available

Bing Webmaster Tools

Queries, pages, rank and traffic, and crawl health from Bing.

Bing Webmaster Tools reports how a site performs in Bing search and how Bingbot crawls it. Connect with a Bing API key or by signing in with Microsoft (read-only); One API for Agents calls the Bing Webmaster API on your behalf.

Provider id
bing
Auth
API key, Sign in with Google or Microsoft (OAuth)
Scopes
webmaster.read read-only
Endpoints
14 raw · 4 smart tools
Schemas
GET /v1/providers/bing
Markdown
/providers/bing.md

Smart tools

Curated calls with compact output for agents. Over MCP each one is a tool with the same name; over REST, pass it as tool.

bing_top_queries

Top Bing search queries by clicks for a site over the last N days, with impressions, CTR and average position. Bing updates this weekly.

Name Type Notes
siteUrl required string Site as added in Bing, e.g. "https://example.com/"
days integer How many days back from the latest available data default 28 · 7–180
limit integer Maximum rows to return default 25 · 1–1000
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "tool": "bing_top_queries",
    "input": {
      "siteUrl": "https://example.com/",
      "days": 28,
      "limit": 10
    }
  }'
MCP tool call
{
  "tool": "bing_top_queries",
  "arguments": {
    "siteUrl": "https://example.com/",
    "days": 28,
    "limit": 10
  }
}

bing_top_pages

Top pages in Bing search by clicks for a site over the last N days, with impressions, CTR and average position.

Name Type Notes
siteUrl required string Site as added in Bing, e.g. "https://example.com/"
days integer How many days back from the latest available data default 28 · 7–180
limit integer Maximum rows to return default 25 · 1–1000
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "tool": "bing_top_pages",
    "input": {
      "siteUrl": "https://example.com/",
      "days": 28,
      "limit": 10
    }
  }'
MCP tool call
{
  "tool": "bing_top_pages",
  "arguments": {
    "siteUrl": "https://example.com/",
    "days": 28,
    "limit": 10
  }
}

bing_crawl_health

Crawl health for a site in Bing: pages in index, crawl and HTTP error totals over the last N days, and the URLs with crawl issues (most linked first).

Name Type Notes
siteUrl required string Site as added in Bing, e.g. "https://example.com/"
days integer How many days back from the latest available data default 30 · 1–180
issueLimit integer default 25 · 0–500
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "tool": "bing_crawl_health",
    "input": {
      "siteUrl": "sc-domain:example.com"
    }
  }'
MCP tool call
{
  "tool": "bing_crawl_health",
  "arguments": {
    "siteUrl": "sc-domain:example.com"
  }
}

bing_list_sites

Sites on the connected Bing Webmaster account and whether each is verified.

No input.

REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "tool": "bing_list_sites",
    "input": {}
  }'
MCP tool call
{
  "tool": "bing_list_sites",
  "arguments": {}
}

Raw endpoints

Passthrough to the Bing Webmaster Tools API. path fills URL placeholders, query the query string and body the JSON body. Input is validated before anything is sent; the response is the provider's own body.

GetUserSites

Read

List the sites on this Bing Webmaster account, with verification status.

GET https://ssl.bing.com/webmaster/api.svc/json/GetUserSites

No input.

REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetUserSites"
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {}
}

GetQueryStats

Read

Top search queries with clicks, impressions and average positions, by week. Updated weekly.

GET https://ssl.bing.com/webmaster/api.svc/json/GetQueryStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetQueryStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetPageStats

Read

Top pages with clicks, impressions and average positions (the page URL is in `Query`). Updated weekly.

GET https://ssl.bing.com/webmaster/api.svc/json/GetPageStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetPageStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetRankAndTrafficStats

Read

Daily clicks and impressions for the whole site. Updated daily.

GET https://ssl.bing.com/webmaster/api.svc/json/GetRankAndTrafficStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetRankAndTrafficStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetQueryPageStats

Read

Pages that ranked for one query, with clicks, impressions and positions.

GET https://ssl.bing.com/webmaster/api.svc/json/GetQueryPageStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
query.query required string
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetQueryPageStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com",
        "query": "example"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        },
        "query": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "siteUrl",
        "query"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetPageQueryStats

Read

Queries that led to one page, with clicks, impressions and positions.

GET https://ssl.bing.com/webmaster/api.svc/json/GetPageQueryStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
query.page required string
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetPageQueryStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com",
        "page": "https://example.com/pricing"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        },
        "page": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "siteUrl",
        "page"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetQueryTrafficStats

Read

Daily clicks and impressions for one query.

GET https://ssl.bing.com/webmaster/api.svc/json/GetQueryTrafficStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
query.query required string
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetQueryTrafficStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com",
        "query": "example"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        },
        "query": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "siteUrl",
        "query"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetCrawlStats

Read

Daily crawl stats for the last 6 months: pages crawled, in index, HTTP code counts, robots.txt blocks.

GET https://ssl.bing.com/webmaster/api.svc/json/GetCrawlStats

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetCrawlStats",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetCrawlIssues

Read

URLs with crawl issues. `Issues` is a bit flag: 1 Code301, 2 Code302, 4 Code4xx, 8 Code5xx, 16 BlockedByRobotsTxt, 32 ContainsMalware, 64 ImportantUrlBlockedByRobotsTxt, 128 DnsErrors, 256 TimeOutErrors.

GET https://ssl.bing.com/webmaster/api.svc/json/GetCrawlIssues

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetCrawlIssues",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetFeeds

Read

Sitemaps and feeds submitted for the site.

GET https://ssl.bing.com/webmaster/api.svc/json/GetFeeds

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetFeeds",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetUrlSubmissionQuota

Read

How many URLs can still be submitted today and this month.

GET https://ssl.bing.com/webmaster/api.svc/json/GetUrlSubmissionQuota

Name Type Notes
query.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetUrlSubmissionQuota",
    "input": {
      "query": {
        "siteUrl": "sc-domain:example.com"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        }
      },
      "required": [
        "siteUrl"
      ]
    }
  },
  "required": [
    "query"
  ]
}

GetKeywordStats

Read

Bing search volume history for a keyword (not tied to your site).

GET https://ssl.bing.com/webmaster/api.svc/json/GetKeywordStats

Name Type Notes
query.q required string
query.country string Country code, e.g. "us"
query.language string Language, e.g. "en-US"
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "GetKeywordStats",
    "input": {
      "query": {
        "q": "example"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "q": {
          "type": "string",
          "minLength": 1
        },
        "country": {
          "description": "Country code, e.g. \"us\"",
          "type": "string"
        },
        "language": {
          "description": "Language, e.g. \"en-US\"",
          "type": "string"
        }
      },
      "required": [
        "q"
      ]
    }
  },
  "required": [
    "query"
  ]
}

SubmitUrl

Writes

Submit one URL for indexing. Uses the site's daily quota.

POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrl

Name Type Notes
body.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
body.url required string (uri)
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "SubmitUrl",
    "input": {
      "body": {
        "siteUrl": "sc-domain:example.com",
        "url": "https://example.com/"
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "body": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      },
      "required": [
        "siteUrl",
        "url"
      ]
    }
  },
  "required": [
    "body"
  ]
}

SubmitUrlBatch

Writes

Submit up to 500 URLs for indexing. Uses the site's daily quota.

POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrlBatch

Name Type Notes
body.siteUrl required string Site as added in Bing, e.g. "https://example.com/"
body.urlList required array<string (uri)>
REST
curl https://api.oneapiforagents.com/v1/call \
  -H "Authorization: Bearer $ONEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "bing",
    "endpoint": "SubmitUrlBatch",
    "input": {
      "body": {
        "siteUrl": "sc-domain:example.com",
        "urlList": [
          "https://example.com/"
        ]
      }
    }
  }'
Input JSON Schema
JSON
{
  "type": "object",
  "properties": {
    "body": {
      "type": "object",
      "properties": {
        "siteUrl": {
          "type": "string",
          "minLength": 1,
          "description": "Site as added in Bing, e.g. \"https://example.com/\""
        },
        "urlList": {
          "minItems": 1,
          "maxItems": 500,
          "type": "array",
          "items": {
            "type": "string",
            "format": "uri"
          }
        }
      },
      "required": [
        "siteUrl",
        "urlList"
      ]
    }
  },
  "required": [
    "body"
  ]
}