Tutorial
How to Reclaim Backlinks Pointing to Broken Pages
Find broken backlink destinations with Claude or ChatGPT and RankParse. Verify source pages, choose relevant repairs and build a practical recovery queue.
By Abhi Bavishi, , 11 min read
A useful article on another website may still recommend your resource long after its URL stops working. The visitor clicks a relevant link and reaches an error page, an unrelated homepage or an obsolete document. You already earned the reference; the immediate problem is the destination.
Reclaiming these links starts with a simple question: can you restore the experience the linking page promised? Sometimes that means restoring a deleted resource. Sometimes it means a permanent redirect to a genuinely equivalent replacement. Sometimes the right action is asking the publisher to update a link after you have fixed the destination.
Claude or ChatGPT can turn backlink candidates into a manageable recovery queue. RankParse supplies URL-level snapshot evidence and live checks of selected public pages. Your team verifies the actual link, chooses the editorially appropriate replacement and implements the repair.
This guide develops that workflow using explicitly illustrative examples. It does not report a live backlink study, and it does not assume that every repaired link will improve rankings.
Separate discovery from verification
A backlink dataset tells you where a link was observed. It does not necessarily tell you whether that link is still present or whether its destination is broken today. Keep those questions separate so the assistant cannot turn an old row into a current claim.
Set up RankParse using the MCP connection guide. The Claude and ChatGPT OAuth connector at https://connect.rankparse.com/mcp supports read-only research. It does not edit your website or send outreach messages. You will use it to collect evidence, then take implementation and publisher contact through your normal tools.
Prepare a scoped input packet containing your bare domain, known retired URL patterns, recent migration notes and a list of important resources. Add any crawler export of broken destinations, analytics records for error pages, and available redirect rules. These inputs help the assistant distinguish a newly discovered problem from a known intentional retirement.
Also state the purpose of the project. Recovering access to research resources differs from cleaning up obsolete campaign links. A page that once hosted a conference registration form may have no appropriate active replacement. A technical reference cited by several relevant publishers may be worth restoring even if it attracts little direct commercial traffic.
Choose a manageable first batch. The size should match your team's ability to verify and implement repairs, not an arbitrary target number of “recovered links.” A small queue with confirmed evidence is easier to act on than a large list of unverified status labels.
Request URL-level rows deliberately
Use get_backlinks with domain, sort=recent, and an explicit limit. If the task concerns clickable editorial links, link_type=hyperlink is a useful filter. The backlinks documentation defines the exact parameters and response shapes.
The choice of sort matters. With sort=importance, a request can return aggregated referring-domain rows. These have link_type: "aggregate", a domain homepage as from_url, and a domain_host_count. They do not identify the article that contains the reference. sort=recent returns URL-level rows, which are the useful starting point for destination recovery.
Retain from_domain, from_url, to_url, anchor_text, rel, link_type and crawled_at. The anchor text helps explain the promise made to a visitor. The source URL lets a reviewer inspect the actual page. The crawl date makes clear that the observation belongs to a snapshot.
“Recent” means newest rows within that dataset, not a live discovery feed. The link graph is periodic, results are bounded, and total is the number of returned rows rather than the domain's entire link count. There is no offset pagination. If you need a different slice, narrow with from_domain or link_type, or increase limit within the documented maximum of 1000. Do not describe repeated identical calls as scanning new pages.
The first prompt keeps discovery honest:
Find backlink-recovery candidates for [bare domain]. I have attached
retired URL patterns, known redirects and our important resources.
Use get_backlinks with sort=recent, link_type=hyperlink and limit=100.
Keep from_url, to_url, anchor_text, rel and crawled_at.
Group rows by exact destination, preserving the original values.
Do not claim a source link is still present or a destination is broken
until separately verified. Report snapshot and coverage limitations.
Return candidate destinations and the reason to inspect each one.A natural-language limit scopes the assignment, but it is not a hard execution cap on an agent. Review the tool activity and use client controls when you need stricter limits. Keep this detail operational; the main task remains restoring useful destinations.
Check each unique destination once
Deduplicate identical to_url values before checking destinations. Preserve the original URLs, including meaningful path case and query parameters. Do not merge distinct URLs merely because they look similar; they may select different resources.
If a citation URL includes a #fragment, keep that original value in the evidence ledger but remove the fragment from the URL sent to get_page_seo; the endpoint rejects fragments. Preserve its path and query parameters. Check whether the cited section still exists separately in a browser. Multiple fragment links can share one page fetch while retaining separate section checks.
Use get_page_seo with this destination url. From its documented response, record status_code, final_url, title.text, canonical.url, robots.raw and the check time. A successful API response does not mean the target is healthy. The target's status_code may still be 404 or 500.
Sort results into working categories that a person can review:
| Observed destination | Next investigation |
|---|---|
| 404 or 410 target | Determine whether the resource was removed intentionally and whether an equivalent exists |
| 5xx target or repeated fetch failure | Ask the technical owner to distinguish service failure from a persistent content problem |
| Final URL differs from the linked URL | Check whether the destination matches the source page's promise |
| 200 response with an error-like title or empty content | Inspect for a soft error, bot challenge or rendering issue |
| Expected page and relevant content | Verify the source link before marking the candidate resolved or healthy |
RankParse reports the final URL after following redirects, not every hop or redirect type. If the repair requires a permanent redirect, verify its initial response and chain with a separate HTTP check or crawler. A correct final URL alone does not prove the transport rule is correct.
The page tool parses raw HTML and does not execute client-side JavaScript. If a document viewer or application renders its content dynamically, inspect the browser experience before declaring it empty. A timeout or bot block is an unknown, not proof of a broken backlink destination.
Verify the reference on the source page
Open the exact from_url and find the link in context. Confirm its destination, surrounding text, visibility and usefulness to the reader. The source may have removed the link, changed its target, moved its article, or stopped publishing altogether since the snapshot observation.
RankParse's get_page_seo can help establish whether the source URL currently resolves, but links.external is only a count. It does not list the external destinations. You cannot use that count to prove the source still links to your broken URL. Use browser inspection, page source or an appropriate crawl export containing actual link destinations.
Record the source-check date separately from crawled_at. If the page requires access you do not have, mark the current link as unverified. You can still repair your own broken resource when independent evidence justifies it, but do not claim a specific publisher's link has been recovered.
Read the surrounding sentence carefully. A link labeled “download the methodology” needs access to the methodology. Sending it to a sales page may preserve a technical connection while failing the reader. That context should determine the replacement, even when another destination is commercially more attractive.
Worked example: choose restoration over a generic redirect
Suppose a fictional logistics software site removed /research/warehouse-transfer-checklist.pdf during a redesign. The following evidence is illustrative, not a real RankParse response or customer outcome.
| Illustrative evidence | Interpretation | Recovery decision |
|---|---|---|
A URL-level backlink row names the checklist PDF in to_url | The snapshot contains a specific resource reference | Inspect that destination and the exact source page |
| A current destination check returns 404 | The resource is currently unavailable to the checker | Investigate the original file and migration history |
| Manual source inspection finds “download the warehouse transfer checklist” still linked | The publisher promises a practical downloadable artifact | Preserve access to a checklist, not just a related category |
| The content team has an approved updated checklist | A relevant replacement exists | Publish it at a stable URL and map the old destination appropriately |
| Separate redirect verification and browser download checks pass | The old request reaches a usable equivalent | Close the destination repair; optionally propose a direct link update |
The repair is defined by the reader's expected artifact. If the old URL can safely serve the approved updated file, restoration may be simplest. If the asset format or location must change, a permanent redirect to the equivalent resource can work. The implementation owner should consider caching, file delivery and existing application routes before choosing.
The source link does not have to change for the visitor experience to improve. A direct-link update can still be useful, but it should not delay a repair your team already controls.
Choose between restore, redirect, update and retire
Restore the original URL when the resource remains useful, you control the location and there is no compelling reason to move it. Check ownership and factual accuracy before republishing old material. Restoring an obsolete calculator with incorrect assumptions would replace one problem with another.
Redirect when a suitable successor exists. Equivalence means satisfying the original task, not merely sharing a keyword. Review merged resources with particular care: a broad guide may mention the old topic without providing the table, download or procedure that earned the link.
Request a publisher update when the current citation is outdated or a better direct destination is available. Provide the exact source page, existing link and proposed replacement. Do not imply that a publisher owes you an update, and do not exaggerate the consequence of their current link.
Retire intentionally when there is no useful replacement and restoration would mislead people. Document the reason. A historical campaign, withdrawn legal claim or unsupported product version may deserve an explicit retirement rather than a convenient redirect. Ranking speculation should not overrule factual accuracy or user expectations.
The second prompt converts reviewed evidence into decisions:
For the verified candidates, recommend restore, redirect, publisher
update, intentional retirement or further investigation. Use the
source sentence and destination evidence to explain each choice.
For every redirect, name the equivalent reader task and what a human
must review. Separate our implementation from publisher actions.
Give each item an owner, prerequisite and observable completion check.
Do not use authority scores as a verdict about link value.Optional score=true adds from_domain_score, anchor_type and link_quality to backlink rows. These can support triage, but a score does not establish topical relevance, referral value or Google's treatment of the link. The backlink quality guide explains how to combine metrics with contextual review.
Make the recovery queue actionable
Use one destination-level repair record with linked source records beneath it in your project system. This avoids creating several competing engineering tickets for the same broken URL while preserving each publisher's context.
Destination recovery record
Original destination:
Discovery source and snapshot date:
Live destination check time and result:
Affected source URLs in the reviewed sample:
Current-source verification and context:
Reader task or promised artifact:
Chosen action and exact replacement:
Reason the replacement is equivalent:
Implementation owner and prerequisite:
Redirect verification evidence, if applicable:
Browser and download acceptance checks:
Publisher update needed:
Retest result and unresolved limitations:These are suggested worksheet fields, not an invented API schema. Keep raw tool output or a stable evidence reference attached to the record so another reviewer can reproduce the conclusion.
Prioritize repairs using relevant context: confirmed source links, usefulness of the resource, referral activity from supplied analytics, business relevance and implementation effort. Distinguish the number of source URLs from unique referring domains within your reviewed sample. Neither number represents complete link coverage, and repeated links from one site should not automatically overwhelm a more valuable isolated reference.
For publisher contact, prepare a short factual draft. Identify the source article, describe the unavailable destination, and provide the working replacement with a one-sentence explanation. Avoid manufactured compliments or claims about the publisher's rankings. The outreach strategy guide offers a broader process when contact is warranted.
Verify repairs and prevent the same breakage
After implementation, recheck the original URL using get_page_seo and inspect the destination in a browser. Confirm the expected final URL, useful content and appropriate canonical declaration. Verify redirects separately, including the response type and intermediate hops. For files, test the actual download and content rather than relying on an HTML-oriented metadata report.
Use a final prompt to prepare the handoff:
Review the recovery queue against the new verification evidence.
Mark destination repairs complete only when the expected resource
works and required redirect checks are documented. Keep source-link
updates separate, with verified, pending or unknown status.
Summarize repaired reader journeys, remaining blockers and preventive
changes. Do not report recovered ranking value or total links beyond
the reviewed evidence. Draft outreach only where requested.A repaired destination may continue to appear in historical backlink data until a later snapshot changes. Conversely, a new snapshot might omit a source you just verified. Use your dated checks to track completion; do not repeatedly query the link graph expecting a live repair confirmation.
Record the repaired routes in your migration inventory and retirement checklist. When teams remove resources, require a decision about known references and useful replacements. The migration checks guide shows how to carry those decisions into a release ledger.
Start with one known broken resource and verify the full journey from source sentence to usable destination. Once that repair is complete, apply the same evidence standard to the next batch. The useful outcome is a restored path for a reader, with a record that explains exactly what was fixed.