Traffic

Get sitemap crawl coverage

Changed on

How AI crawlers consume the site's sitemap: per bot, how many times it fetched the sitemap and how often, how many sitemap-listed pages it went on to discover, and the median lag from a page appearing in the sitemap to its first crawl. Use it to answer whether newly published pages are actually reaching AI crawlers. Returns 409 traffic_not_connected if no tracker/CDN/log source is connected.

get/api/mcp/projects/{projectId}/traffic/sitemap-coverage

Request

  • Base URL
    https://app.searchable.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring uuid required

The project id.

Query parameters

daysinteger

Lookback window in days. Default and maximum vary by endpoint — see the operation description.

fromstring
Example:2026-03-01

Start of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires to, and is mutually exclusive with days — sending both returns 400 invalid_argument. A range longer than the endpoint's maximum is rejected rather than clamped.

tostring
Example:2026-03-31

End of an absolute window (inclusive, UTC). Accepts YYYY-MM-DD or a full ISO timestamp. Requires from.

hoststring
Example:blog.acme.com

Comma-separated hostnames to narrow the report to. Useful on multi-domain projects; omit for every host in the project.

Response

Sitemap crawl coverage per bot.

Changes