PlugsightDocs

Bing Webmaster Tools tools

Every Bing Webmaster Tools tool in the developer API, with its arguments and an example call.

Updated

Needs: A Bing Webmaster Tools connection (Pro and Agency; Free can try 1 connection and 25 calls a month). 5 tools.

These tools appear in GET /v1/tools only when the API key's MCP server includes a connection of this kind. Call each one with POST /v1/tools/\<name>, sending its arguments as a JSON object. See Calling tools for the request and response format.

Tool What it does Kind
bing_webmaster_sites List Bing Webmaster sites Read
bing_webmaster_search_performance Bing search performance Read
bing_webmaster_crawl Bing crawl stats Read
bing_webmaster_sitemaps Bing sitemaps Read
bing_webmaster_url_info Bing index details for a page Read

The example requests fill in only the required arguments, with placeholder values.

bing_webmaster_sites

List Bing Webmaster sites · Read

The sites in this Bing Webmaster Tools account that AI apps may use, and whether each is verified. Use a site's URL in the other Bing Webmaster tools.

Argument Type Required What it is
account string No Bing Webmaster connection id from list_accounts (optional when there's only one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/bing_webmaster_sites \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

bing_webmaster_search_performance

Bing search performance · Read

How a site does in Bing search: clicks and impressions by day, and its top search queries and pages with clicks, impressions, CTR and average position. Bing keeps about six months and reports queries and pages by week, so from/to pick whole weeks. Default: everything Bing has.

Argument Type Required What it is
account string No Bing Webmaster connection id from list_accounts (optional when there's only one)
site_url string No Site exactly as bing_webmaster_sites lists it, e.g. https://example.com/ (optional when the account has one)
from string No YYYY-MM-DD
to string No YYYY-MM-DD
top integer No How many top queries and pages (by clicks) Default 25.
sort_by string No Field to sort by. One of: clicks, impressions. Default "clicks".

Example request:

curl -X POST https://app.plugsight.app/v1/tools/bing_webmaster_search_performance \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

bing_webmaster_crawl

Bing crawl stats · Read

How Bing crawls a site, day by day: pages crawled, pages in the index, crawl errors, blocked by robots.txt, and responses by status (2xx, 301, 4xx, 5xx). About six months.

Argument Type Required What it is
account string No Bing Webmaster connection id from list_accounts (optional when there's only one)
site_url string No Site exactly as bing_webmaster_sites lists it, e.g. https://example.com/ (optional when the account has one)
from string No YYYY-MM-DD
to string No YYYY-MM-DD

Example request:

curl -X POST https://app.plugsight.app/v1/tools/bing_webmaster_crawl \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

bing_webmaster_sitemaps

Bing sitemaps · Read

The sitemaps and feeds submitted for a site in Bing Webmaster Tools, with what Bing reports for each.

Argument Type Required What it is
account string No Bing Webmaster connection id from list_accounts (optional when there's only one)
site_url string No Site exactly as bing_webmaster_sites lists it, e.g. https://example.com/ (optional when the account has one)

Example request:

curl -X POST https://app.plugsight.app/v1/tools/bing_webmaster_sitemaps \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

bing_webmaster_url_info

Bing index details for a page · Read

What Bing knows about one page of a site: whether and when it was discovered and crawled, and its index details.

Argument Type Required What it is
account string No Bing Webmaster connection id from list_accounts (optional when there's only one)
site_url string No Site exactly as bing_webmaster_sites lists it, e.g. https://example.com/ (optional when the account has one)
url string Yes The page's full URL

Example request:

curl -X POST https://app.plugsight.app/v1/tools/bing_webmaster_url_info \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "…"}'