> ## Documentation Index
> Fetch the complete documentation index at: https://dev.ranked.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Backlink History

> Get daily new and lost backlink counts over time

Returns daily backlink change data for trend analysis.

<ParamField path="projectId" type="string" required>Project UUID</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.ranked.ai/api/v1/projects/{projectId}/backlinks/history" \
    -H "Authorization: Bearer rk_live_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    `https://app.ranked.ai/api/v1/projects/${projectId}/backlinks/history`,
    { headers: { 'Authorization': `Bearer ${apiKey}` } }
  );
  const { data } = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      f'https://app.ranked.ai/api/v1/projects/{project_id}/backlinks/history',
      headers={'Authorization': f'Bearer {api_key}'}
  )
  history = response.json()['data']
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "history": [
        {
          "check_date": "2026-05-01",
          "new_backlinks": 3,
          "lost_backlinks": 1,
          "new_referring_domains": 2,
          "lost_referring_domains": 0,
          "net_backlinks_change": 2,
          "net_domains_change": 2
        },
        {
          "check_date": "2026-04-24",
          "new_backlinks": 5,
          "lost_backlinks": 0,
          "new_referring_domains": 4,
          "lost_referring_domains": 1,
          "net_backlinks_change": 5,
          "net_domains_change": 3
        }
      ],
      "summary": {
        "total_new": 8,
        "total_lost": 1,
        "net_change": 7
      }
    }
  }
  ```
</ResponseExample>