Link Health
developer/v1/domain/link-healthChecks the health of links on a page including broken links, redirect chains, anchor text quality, and link attribute analysis. Identifies issues that hurt SEO and user experience.
What It Does
Crawls the target page, extracts all internal and external links, then checks each link's HTTP status. Reports broken links (4xx/5xx), redirect chains with hop counts, link attributes (nofollow, sponsored, ugc), and anchor text quality (generic, empty, or descriptive). Returns a health score with actionable recommendations.
Why It's Useful
Broken links damage SEO rankings, user experience, and credibility. Redirect chains dilute link equity and slow page loads. Regular link health checks prevent these issues from accumulating.
Use Cases
Broken Link Audit
Scan pages for broken internal and external links that return 404 or 5xx errors.
Fix broken links before they impact search rankings and user experience.
Post-Migration Validation
After a site migration, verify all links still resolve correctly and redirect chains are minimal.
Catch link issues introduced during migration before they impact traffic.
Content Quality Check
Audit anchor text quality across the site to identify generic or empty link text.
Improve internal linking with descriptive anchor text for better SEO.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | The domain to check link health forExample: example.com |
limit | number | Optional | Maximum number of links to check (1-200, default: 50)Example: 50 |
Response Fields
| Field | Type | Description |
|---|---|---|
domain | string | The checked domain |
summary | object | Total, broken, redirected, healthy, and timeout link counts |
brokenLinks | array | Broken links with status codes and anchor text |
redirectChains | array | Redirect chains with hop counts and status codes |
linkAttributes | object | Counts of nofollow, sponsored, ugc attributes |
anchorText | object | Anchor text quality analysis |
score | number | Link health score 0-100 |
grade | string | Letter grade A-F |
breakdown | object | Per-component score breakdown with weights for broken links, redirects, anchor text, empty anchors, nofollow ratio, internal/external balance, and status distribution |
recommendations | array | Specific link fixes to implement |
Code Examples
curl "https://api.edgedns.dev/v1/domain/link-health" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain=example.com"const response = await fetch(
'https://api.edgedns.dev/v1/domain/link-health?domain=example.com',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/domain/link-health',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': 'example.com'
}
)
data = response.json()
print(data)Read the full Link Health guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.