Re-check one page's links now
const url = 'https://api.overwatch.weareheavy.dev/v1/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/page/recheck';const options = { method: 'POST', headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'}, body: '{"url":"https://example.com"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.overwatch.weareheavy.dev/v1/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/page/recheck \ --header 'Content-Type: application/json' \ --header 'x-api-key: <x-api-key>' \ --data '{ "url": "https://example.com" }'Re-reads the live page and re-checks every link on it (up to 100, plus any that were broken before) within the crawl’s scope. The fresh result replaces the page’s problem links in the latest crawl. Only links are re-checked; other findings refresh with the next crawl. Allowed for read-only keys. One re-check per page per 30 seconds.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”The site’s UUID.
Request Bodyrequired
Section titled “Request Bodyrequired”object
A page on the site’s own host.
Examplegenerated
{ "url": "https://example.com"}Responses
Section titled “ Responses ”What changed, and the fresh page view.
object
object
Epoch ms.
Distinct in-scope links on the live page.
Targets broken before that now answer or are no longer linked.
object
The page key the URL resolved to.
object
The latest completed crawl.
object
Whether the latest crawl reached the page; null when it can’t tell (SEO app off).
The page as the latest crawl read it (SEO app).
object
Other pages linking here.
Clicks from the homepage.
object
One finding on a page, from any app.
object
Stable id where the source keeps one (SEO issues, broken-link rows).
broken-link, unverified-link, an SEO rule id, an axe rule id, or a google-* rule id.
Why it matters, in editor words.
What to do about it. Empty for accessibility rules (see helpUrl).
The offending value — a link target, the current title, Google’s canonical.
Links only.
object
Null = no answer (timeout, network error).
The link’s anchor text.
Best-effort CSS selector into the page.
Accessibility only — affected elements on the page.
Accessibility only — the rule’s documentation.
SEO only — epoch ms.
SEO only — opened in the latest crawl.
Accessibility only — up to five affected elements as the crawler saw them. src is an image’s absolute URL, so a CMS can find the image (and its alt text field) in the document.
object
Search Console, last 28 days. Null when not connected.
object
The 28 days before. Null when the page earned nothing then.
object
The searches leading to the page, most clicks first (up to 10).
object
Google’s last URL Inspection of the page.
object
slipping (clicks, previousClicks, delta), low-ctr (position,
ctr, expectedCtr) or striking-distance (queries).
object
The page’s last re-check, epoch ms.
Example
{ "page": { "findings": [ { "source": "links", "severity": "critical", "link": { "kind": "internal" } } ], "insights": [ { "kind": "slipping" } ] }}A missing URL, or a URL off the site’s host.
object
A human-readable error message.
Example
{ "error": "url must be a page on example.com"}Missing or invalid credentials.
object
A human-readable error message.
Example
{ "error": "invalid api key"}The site was not found, has no crawl yet, or broken links is not enabled.
object
A human-readable error message.
Example
{ "error": "no runs yet"}The live page couldn’t be read (an error status, an off-site redirect, not HTML).
object
A human-readable error message.
Example
{ "error": "the page answers 404"}The page was re-checked less than 30 seconds ago.
object
A human-readable error message.
Example
{ "error": "checked less than 30 seconds ago — try again shortly"}