Unif API Docs
seoBacklinks

Get historical backlink metrics for a target

Return a monthly time series of a target's backlink profile since 2019 — backlinks, referring domains, new/lost counts, and rank — for link-growth trend analysis.

Pricing — $$ · min $0.05

Minimum 50 credits ($0.05) per call. Records returned above the minimum bill 1 credit ($0.001) each.

POST
/seo/backlinks/history

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/seo/backlinks/history" \  -H "Content-Type: application/json" \  -d '{    "target": "string"  }'
{
  "request_id": "string",
  "data": {
    "target": "string",
    "view": "summary",
    "date_from": "string",
    "date_to": "string",
    "series": [
      {
        "date": "string",
        "new_backlinks": 0,
        "lost_backlinks": 0,
        "new_referring_domains": 0,
        "lost_referring_domains": 0,
        "crawled_pages": 0,
        "rank": 0,
        "backlinks": 0,
        "backlinks_spam_score": 0,
        "first_seen": "string",
        "lost_date": "string",
        "broken_backlinks": 0,
        "broken_pages": 0,
        "referring_domains": 0,
        "referring_main_domains": 0,
        "referring_pages": 0,
        "referring_ips": 0,
        "referring_subnets": 0,
        "referring_domains_nofollow": 0,
        "referring_main_domains_nofollow": 0,
        "referring_pages_nofollow": 0,
        "referring_links_tld": {
          "property1": 0,
          "property2": 0
        },
        "referring_links_types": {
          "property1": 0,
          "property2": 0
        },
        "referring_links_attributes": {
          "property1": 0,
          "property2": 0
        },
        "referring_links_platform_types": {
          "property1": 0,
          "property2": 0
        },
        "referring_links_semantic_locations": {
          "property1": 0,
          "property2": 0
        },
        "referring_links_countries": {
          "property1": 0,
          "property2": 0
        }
      }
    ]
  },
  "billing": {
    "credits_charged": 0,
    "records_charged": 0,
    "balance_remaining": 0,
    "truncated_due_to_balance": true
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}
{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

List target pages ranked by backlinks POST

Return the pages of a target domain or subdomain that receive backlinks, each with crawl data and backlink counters, to find the most-linked pages of a site.

List individual backlinks pointing to a target POST

Return the individual backlinks pointing to a target domain, subdomain, or page, each with the referring URL, anchor, dofollow flag, rank, and spam score, for detailed link auditing.