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

# Referring Domains

> Get referring domains with domain rank, backlink count, and follow status

Returns paginated referring domains sorted by domain rank.

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

<ParamField query="limit" type="number" default="50">
  Maximum domains to return (max: 1000)
</ParamField>

<ParamField query="offset" type="number" default="0">
  Number to skip for pagination
</ParamField>

<ParamField query="sort_by" type="string" default="domain_rank">
  Sort by: `domain_rank`, `backlinks_count`, or `first_seen`
</ParamField>

<ParamField query="sort_order" type="string" default="desc">
  `asc` or `desc`
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.ranked.ai/api/v1/projects/{projectId}/backlinks/domains?limit=10&sort_by=domain_rank" \
    -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/domains?limit=10&sort_by=domain_rank`,
    { headers: { 'Authorization': `Bearer ${apiKey}` } }
  );
  const { data, meta } = await response.json();
  ```

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

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "domain": "www.bbb.org",
        "backlinks_count": 2,
        "domain_rank": 89,
        "is_dofollow": false,
        "first_seen": "2025-10-03T02:54:17+00:00"
      },
      {
        "domain": "www.iheart.com",
        "backlinks_count": 1,
        "domain_rank": 82,
        "is_dofollow": true,
        "first_seen": "2026-01-15T10:22:00+00:00"
      }
    ],
    "meta": {
      "pagination": {
        "total": 57,
        "limit": 10,
        "offset": 0,
        "has_more": true
      }
    }
  }
  ```
</ResponseExample>