List SEO issues with their lifecycle
const url = 'https://api.overwatch.weareheavy.dev/v1/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/seo-issues?status=open&severity=critical&limit=100';const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.overwatch.weareheavy.dev/v1/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/seo-issues?status=open&severity=critical&limit=100' \ --header 'x-api-key: <x-api-key>'SEO issues with a stable identity across crawls. There is one issue per
rule per page, and each issue is new, open, resolved (fixed or
page-gone) or reopened. Newest first, keyset-paginated: follow
nextCursor until it’s null. The site’s excludePaths globs are
applied after paging, so a page of results can hold fewer than limit
issues.
Intended for CMS integrations. Pass url to show a document’s issues
in the editor, or new=true to list what broke in the latest crawl.
Responds 404 when the SEO app is not enabled for the site.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”The site’s UUID.
Query Parameters
Section titled “Query Parameters”true returns open issues opened, or reopened after a fix, in the
latest crawl. After a starting-point (baseline) crawl, nothing is new.
A run id. Returns issues opened, reopened after a fix, or resolved in that run.
An absolute page URL. It is keyed the way the crawler keys pages
(www/non-www folding, the site’s stripParams dropped), so a
document’s public URL matches as-is.
A rule id from the SEO rule catalog (e.g. meta-noindex).
The opaque nextCursor from the previous page.
Responses
Section titled “ Responses ”A page of issues.
object
The latest SEO-extracting run, which isNew and new=true are relative to.
object
One SEO finding (a rule on a page) with its lifecycle across crawls.
object
Stable across crawls. Also carried by seo.indexability_lost webhooks.
The latest observed severity.
What to change to resolve it, in editor terms.
The latest observation’s specifics.
The latest offending value (title/description/canonical/robots text).
Opened, or reopened after a fix, in the latest crawl.
Epoch ms.
fixed: the page was crawled and the rule no longer fires.
page-gone: a complete crawl no longer reaches the page.
Times this issue came back after being fixed.
Example
{ "issues": [ { "severity": "critical", "status": "open", "resolution": "fixed" } ]}An invalid filter, limit, cursor, or URL.
object
A human-readable error message.
Example
{ "error": "status must be one of: open, resolved, all"}Missing or invalid credentials.
object
A human-readable error message.
Example
{ "error": "invalid api key"}The site was not found, or the SEO app is not enabled.
object
A human-readable error message.
Example
{ "error": "SEO is not enabled for this site"}