Skip to content
Website & Domain

Backlink Overview

A domain's link profile: referring domains, follow split, anchors and top links.

POST/v1/backlink-overview
13 credits / reportBulk supportedGlobal
Request
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"}'
Response
{
  "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>required

Your 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>required

Domain. Example: example.com

freshboolean

Skip the 7-day cache and run a new lookup. Charged as a normal lookup.

referencestring

Your 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.

successboolean

true when the lookup ran.

data.referring_domainsnumber

Count of unique domains that link to the target.

data.backlinks.follownumber

Follow and nofollow counts in one backlinks object, next to the total.

data.top_anchorsarray

The most common anchor texts and how many links use each.

data.top_referring_domainsarray

The domains sending the most links.

data.new_30dobject

Referring domains and backlinks first seen in the last 30 days.

data.lost_30dobject

Referring domains and backlinks that disappeared over the same period.

data.linksarray

Up to 1,000 individual backlinks with source URL, target URL, anchor and follow status.

meta.credits_usednumber

Credits charged for this call.

meta.credits_remainingnumber

Your balance after the call.

meta.cachedboolean

true when the result came from the 7-day cache.

meta.request_idstring

Quote 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.

HTTPCodeMeaning
401unauthorizedThe key is missing, malformed or revoked.
402insufficient_creditsYour credits are used up and pay as you go is off or at its limit.
422invalid_inputA field is missing or malformed. The field property names it.
429rate_limitedToo many requests for this key. Wait for the Retry-After interval.
500internal_errorSomething failed on our side. Safe to retry.
503source_unavailableAn 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