Backlink Overview
A domain's link profile: referring domains, follow split, anchors and top links.
curl -X POST https://api.1lookup.dev/v1/backlink-overview \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"example.com"}'{
"success": true,
"data": {
"domain": "example.com",
"referring_domains": 2315,
"backlinks": {
"total": 31840,
"follow": 26110,
"nofollow": 5730
},
"new_30d": {
"referring_domains": 62,
"backlinks": 410
},
"lost_30d": {
"referring_domains": 37,
"backlinks": 288
},
"top_anchors": [
{
"anchor": "example",
"backlinks": 6120
},
{
"anchor": "example.com",
"backlinks": 3475
},
{
"anchor": "clinic scheduling software",
"backlinks": 890
}
],
"top_referring_domains": [
{
"domain": "blog.fabrikam.example",
"backlinks": 214
},
{
"domain": "contoso-roasters.example",
"backlinks": 131
}
],
"links": [
{
"source_url": "https://blog.fabrikam.example/tools-we-use",
"target_url": "https://example.com/",
"anchor": "example",
"follow": true,
"first_seen": "2025-08-14"
},
{
"source_url": "https://contoso-roasters.example/partners",
"target_url": "https://example.com/pricing",
"anchor": "clinic scheduling software",
"follow": false,
"first_seen": "2026-10-27"
}
]
},
"meta": {
"credits_used": 13,
"credits_remaining": 999,
"cached": false,
"request_id": "req_8f3a2c1e9b7d"
}
}Authorization
Authorizationstring<bearer>requiredYour API key as a Bearer token. Live keys start with 1lk_live_. Test keys start with 1lk_test_ and return this endpoint's sample response without spending credits. See authentication.
Body
Send the fields as a JSON object with Content-Type: application/json.
domainstring<domain>requiredDomain. Example: example.com
freshbooleanSkip the 7-day cache and run a new lookup. Charged as a normal lookup.
referencestringYour own identifier, echoed back in meta and shown in lookup history.
Response
A 200 response carries the result in data and the cost of the call in meta. These are the fields most integrations read.
successbooleantrue when the lookup ran.
data.referring_domainsnumberCount of unique domains that link to the target.
data.backlinks.follownumberFollow and nofollow counts in one backlinks object, next to the total.
data.top_anchorsarrayThe most common anchor texts and how many links use each.
data.top_referring_domainsarrayThe domains sending the most links.
data.new_30dobjectReferring domains and backlinks first seen in the last 30 days.
data.lost_30dobjectReferring domains and backlinks that disappeared over the same period.
data.linksarrayUp to 1,000 individual backlinks with source URL, target URL, anchor and follow status.
meta.credits_usednumberCredits charged for this call.
meta.credits_remainingnumberYour balance after the call.
meta.cachedbooleantrue when the result came from the 7-day cache.
meta.request_idstringQuote this when you contact support.
Errors
A failed request returns success: false with an error object, and is never charged. The full list is on the errors page.
| HTTP | Code | Meaning |
|---|---|---|
| 401 | unauthorized | The key is missing, malformed or revoked. |
| 402 | insufficient_credits | Your credits are used up and pay as you go is off or at its limit. |
| 422 | invalid_input | A field is missing or malformed. The field property names it. |
| 429 | rate_limited | Too many requests for this key. Wait for the Retry-After interval. |
| 500 | internal_error | Something failed on our side. Safe to retry. |
| 503 | source_unavailable | An upstream source did not answer in time. Safe to retry. |
Billing
13 credits / report. Charged when the lookup runs and returns a result. Errors are never charged, and repeating the same input within 7 days is served from cache at no charge.
Product overview and use cases