# Referring Domains

Source: https://www.ranked.ai/developers/api-reference/backlinks/domains

`GET https://app.ranked.ai/api/v1/projects/{projectId}/backlinks/domains`

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

Returns paginated referring domains sorted by domain rank.

- `projectId` (path, string, required): Project UUID

- `limit` (query, number, default 50): Maximum domains to return (max: 1000)

- `offset` (query, number, default 0): Number to skip for pagination

- `sort_by` (query, string, default domain_rank): Sort by: `domain_rank`, `backlinks_count`, or `first_seen`

- `sort_order` (query, string, default desc): `asc` or `desc`

**Request**

```bash cURL
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
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
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']
```

**Response**

```json 200
{
  "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
    }
  }
}
```