# Backlink Summary

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

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

> Get aggregated backlink metrics for a project

Returns total backlinks, referring domains, and dofollow/nofollow breakdown.

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

**Request**

```bash cURL
curl "https://app.ranked.ai/api/v1/projects/{projectId}/backlinks/summary" \
  -H "Authorization: Bearer rk_live_your_api_key"
```

```javascript JavaScript
const response = await fetch(
  `https://app.ranked.ai/api/v1/projects/${projectId}/backlinks/summary`,
  { headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const { data } = await response.json();
console.log(`${data.total_backlinks} backlinks from ${data.total_referring_domains} domains`);
```

```python Python
import requests

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

**Response**

```json 200
{
  "success": true,
  "data": {
    "project_id": "40596405-c27c-4dfc-89e4-142c87846d66",
    "total_backlinks": 58,
    "total_referring_domains": 54,
    "average_domain_rank": 0,
    "dofollow_backlinks": 0,
    "nofollow_backlinks": 0,
    "broken_backlinks": 0,
    "tracked_domains_count": 1,
    "last_updated": "2026-05-02"
  }
}
```