---
title: "Get Site Backlinks"
method: GET
path: "/sites/{site_id}/backlinks"
tags: ["sites"]
---

# Get Site Backlinks

`GET /sites/{site_id}/backlinks`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/sites/{site_id}/backlinks`
- Auth: API key in header `X-Agent-Key`

Return the backlink profile for a site.

Results are cached for 24 h. Pass ``force_refresh=true`` to trigger a live,
cursor-paginated DataForSEO fetch. Requires DataForSEO credentials.

## Path parameters

- `site_id` string, required

## Query parameters

- `email` string, nullable
- `force_refresh` boolean
- `domain` string, nullable

## Response `200`

Successful Response

- BacklinkProfileResponse
  - `summary` BacklinkSummary, required
    - `backlinks_count` integer, nullable
    - `referring_domains` integer, nullable
    - `domain_rank` number, nullable
    - `dofollow_count` integer
    - `nofollow_count` integer
    - `active_links` integer
    - `new_links` integer
    - `lost_links` integer
    - `top_anchors` object[]
    - `suspect_links` integer
    - `suspect_new_links` integer
    - `risk_breakdown` object
    - `potentially_harmful_domains` integer
  - `detail` BacklinkDetailItem[]
    - `referring_domain` string
    - `source_title` string
    - `source_url` string, required
    - `target_url` string
    - `anchor_text` string, required
    - `alt_text` string
    - `image_url` string
    - `item_type` string
    - `attributes` string[]
    - `dofollow` boolean, required
    - `semantic_location` string
    - `page_type` 'Blog' | 'News' | 'Article' | 'Homepage' | 'Category' | 'Product' | 'Collection' | 'Service' | 'Landing Page' | 'Directory' | 'Forum' | 'Community' | 'Wiki' | 'Documentation' | 'Knowledge Base' | 'Resource Page' | 'Tools Page' | 'Profile Page' | 'Business Listing' | 'Press Release' | 'Event' | 'Job Listing' | 'Review' | 'Portfolio' | 'Case Study' | 'FAQ' | 'Contact' | 'About' | 'Author Page' | 'Tag Page' | 'Archive' | 'Search Results' | 'Login/Register' | 'Media (Image/Video/PDF)' | 'Coupon' | 'Affiliate' | 'Sponsored Content' | 'Government' | 'Educational' | 'Non-Profit' | 'E-commerce'
    - `language` string
    - `mobile_friendly_status` 'Mobile friendly' | 'Not mobile friendly', nullable
    - `first_seen` string, nullable
    - `last_seen` string, nullable
    - `page_rank` integer
    - `links_count` integer
    - `external_links` integer
    - `internal_links` integer
    - `source_status_code` integer, nullable
    - `link_status` string
    - `spam_score` integer, nullable
    - `toxicity_score` number
    - `risk_level` 'low' | 'medium' | 'high'
    - `reasons` string[]
  - `fetched_at` string, nullable
  - `from_cache` boolean
  - `fetch_status` string, nullable
  - `fetch_error` string, nullable
  - `provider` BacklinkProviderInfo
    - `name` string
    - `connected` boolean
    - `status` string
    - `action_url` string, nullable
    - `authority_metric` string
    - `authority_scale` string
    - `coverage` string
    - `refresh_frequency` string
  - `last_successful_refresh` string, nullable
  - `suspect` object[]
  - `top_anchors` object[]
  - `note` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)