Find the representative pages of a website from its sitemaps, before generating a persona brief (free tool)
Reads the sitemaps of a website (declared in robots.txt, otherwise /sitemap.xml, /sitemap_index.xml and /wp-sitemap.xml) and returns up to 200 URLs of the same host, editorial pages first. The first URLs, as many as the URL limit of your tier, are flagged suggested: send them in urls to POST /api/v1/tools/persona-brief.
Same tiers as the creation call, with their own daily counter per UTC day: 20 discoveries per day per IP address without an API key, 50 for a signed-in account, 200 with the API key of an account whose plan includes API access. A key whose plan does not include API access returns 401: remove the Authorization header to use the free anonymous tier.
Quota headers: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Remaining, X-RateLimit-Reset. Retry-After is set on 429 and 503. A 400, 502 or 503 answer gives the consumed quota back; SERVICE_UNAVAILABLE consumes none.
Request format. Send the body as JSON with Content-Type: application/json: any other content type returns 415. Without an Authorization header, a request sent by a web page of another site (an Origin other than the SERPmantics app, or Sec-Fetch-Site: cross-site) returns 403. Server-to-server calls send no Origin header and are not affected.
Request
- Base URL: https://app.serpmantics.com (the document declares no server; this is the origin it was published from)
- URL: https://app.serpmantics.com/api/v1/tools/persona-brief/discover
- Auth: one of:
- none
- HTTP bearer
Request body
Example request
{
"site": "https://serpmantics.com/"
}Response
Pages found in the sitemaps.
Example response
{
"success": true,
"data": {
"urls": [
{
"lastmod": "2026-09-14T00:00:00Z"
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.