---
title: Analyze Backlinks API
slug: backlinks
url: https://apyhub.com/se-ranking/service/backlinks
provider: "SE Ranking SEO & AI Search API"
categories: [SEO]
tags: [backlinks, seo, link-analysis, referring-domains, anchor-text, domain-authority]
auth: api_key
---

# Analyze Backlinks API

Analyze the full backlink profile of any domain or URL. Powered by SE Ranking data for link audits, competitor research, and outreach planning.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/export` | What it does Starts an asynchronous export of backlinks data for the specified target and returns a… | 2000 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/export/status` | What it does Checks the status of a backlink export task and returns the task identifier, current t… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips` | What it does Returns a JSON object containing a referringips array for the specified target. Each a… | 750 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips` | What it does Lists the referring IPs for a target passed in the request body. The response returns… | 750 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-subnets/count` | What it does Returns the total count of referring subnets (C-blocks) for a given target. The reques… | 100 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-subnets/count` | What it does Counts the total number of referring subnets for the submitted target(s) and returns t… | 100 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain` | What it does Retrieves the domain authority data for the specified target domain and returns it as… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain` | What it does Calculates domain authority for the target domain(s) you submit in the request body. T… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history/count` | What it does Retrieves the daily count of new and lost referring domains for a target, using query… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history/count` | What it does Returns the daily count of new and lost referring domains for a target. You send the t… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/indexed-pages` | What it does Returns a JSON object containing a pages array of indexed pages related to the supplie… | 1000 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/indexed-pages` | What it does Returns a JSON object containing a pages array of indexed pages related to the supplie… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain/distribution` | What it does Returns the authority distribution for a target passed as a query parameter. The respo… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/count` | What it does Returns the total referring domains count for a specified target. You provide the targ… | 500 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/count` | What it does Returns the total referring domains count for the provided target in the request body.… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/raw` | What it does Fetches backlinks for a target in cursor-based batches. The request is sent as query p… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history` | What it does Returns a list of referring domains that are new or lost for the specified target, wit… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history` | What it does Returns a list of referring domains that are new or lost for the specified target, fil… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page` | What it does Returns the page authority information for a target URL. The response contains an auth… | 500 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page` | What it does Calculates page authority for the target URL(s) provided in the request body and retur… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain/history` | What it does Returns the domain authority history for a target domain as a JSON object containing a… | 250 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains` | What it does Returns a JSON object containing a refdomains array of referring-domain records for th… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains` | What it does Lists referring domains for a target provided in the request body. The endpoint return… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority` | What it does Returns page and domain authority metrics for the requested target. The request is sen… | 250 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority` | What it does Returns authority data for one or more target URLs submitted in the request body. The… | 250 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/cumulative` | What it does Retrieves cumulative backlinks history for a target and returns the backlink count ove… | 250 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/cumulative` | What it does Returns cumulative backlink counts over time for a specified target. You provide the t… | 250 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/anchors` | What it does Returns backlink anchor text data for the specified target. The response contains an a… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/anchors` | What it does Retrieves backlink anchor texts for the target you provide in the request body and ret… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/summary` | What it does Returns backlink summary data for the specified target. You can choose the lookup mode… | 2000 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/summary` | What it does Returns backlink summary data for one target or a batch of targets submitted in the re… | 2000 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/metrics` | What it does Retrieves backlink-related metrics for the specified target using query parameters. Th… | 250 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/metrics` | What it does Returns backlink metrics for one target or a batch of targets submitted in the request… | 250 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/all` | What it does Returns a list of backlinks for the supplied target, with optional query parameters to… | 250 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/all` | What it does Retrieves a list of backlinks for the specified target and returns them in a JSON obje… | 250 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/count` | What it does Returns the total backlinks count for the specified target, with optional query contro… | 500 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/count` | What it does Counts the total number of backlinks for the target you submit in the request body. Yo… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history` | What it does Returns a list of new and lost backlinks for the specified target, with optional filte… | 200 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history` | What it does Returns a list of new and lost backlinks for the target you submit in the request body… | 200 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page/history` | What it does Gets the page authority history for a target URL or domain over a requested date range… | 500 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/count` | What it does Returns daily counts of new and lost backlinks for the specified target. The endpoint… | 1000 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/count` | What it does Returns a JSON object containing newlostbacklinkscount, an array of daily backlink cou… | 1000 |
| GET | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips/count` | What it does Returns the total referring IPs count for the specified target. The request accepts th… | 100 |
| POST | `https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips/count` | What it does Returns referring IP count metrics for the supplied target in the request body. The re… | 100 |

## Examples

### Export Backlinks

#### Quickstart

Export backlink data for a target URL, domain, or host with the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/export?target=apyhub.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with optional `task_id` and `task_status` fields. `task_id` is a string for the created export task, and `task_status` is a string such as `queued_for_processing`, `processing`, `complete`, `rejected`, or `unknown`.

```json
{
  "task_id": "task_12345",
  "task_status": "queued_for_processing"
}
```

### Check Backlinks Export Status

#### Quickstart

Check the export task status by passing the required `task_id` as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/export/status?task_id=task-12345" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with optional top-level `task_id`, `task_status`, and `download_file` fields.

- `task_id` is a string for the task being checked.
- `task_status` is a string enum such as `queued_for_processing`, `processing`, `complete`, `rejected`, or `unknown`.
- `download_file` is a string URL or path when available, or `null`.

```json
{
  "task_id": "task-12345",
  "task_status": "complete",
  "download_file": "https://example.com/download.csv"
}
```

### List Referring IPs

#### Quickstart

Fetch the referring IPs for a target host, domain, or URL with the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `referring_ips` array. Each item is an object with `ip`, `backlinks`, and `refdomains` fields.

```json
{
  "referring_ips": [
    {
      "ip": "192.0.2.10",
      "backlinks": 42,
      "refdomains": 7
    }
  ]
}
```

### Count Referring Subnets

#### Quickstart

Look up the referring IPs for a target backlink profile.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `referring_ips` array. Each item is an object with `ip`, `backlinks`, and `refdomains` fields.

```json
{
  "referring_ips": [
    {
      "ip": "192.0.2.1",
      "backlinks": 42,
      "refdomains": 7
    }
  ]
}
```

### referring-subnets/count

#### Quickstart

Get the count of referring subnets for a target by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-subnets/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `referring_subnets` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "referring_subnets": 42
    }
  ]
}
```

### referring-subnets/count

#### Quickstart

Count referring subnets for a target domain, host, or URL using the default JSON output.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-subnets/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com","mode":"domain"}'
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with `target` as a string and `referring_subnets` as an integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "referring_subnets": 42
    }
  ]
}
```

### Get Domain Authority

#### Quickstart

Look up backlink authority for a domain by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain?target=apyhub.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item in the array is an object with a `target` string and a `domain_inlink_rank` integer.

```json
{
  "authority": [
    {
      "target": "example.com",
      "domain_inlink_rank": 42
    }
  ]
}
```

### Get Domain Authority

#### Quickstart

Look up backlink authority for one target domain.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":["apyhub.com"]}'
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item is an object with `target` as a string and `domain_inlink_rank` as an integer.

```json
{
  "authority": [
    {
      "target": "example.com",
      "domain_inlink_rank": 42
    }
  ]
}
```

### Get New/Lost Referring Domains — Daily Counts

#### Quickstart

Check backlink referring domain history count for a target, using the required query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `new_lost_refdomains_count` array. Each item in the array is an object that can include `new` and `lost` integers plus a `date` string in `date` format.

```json
{
  "new_lost_refdomains_count": [
    {
      "new": 12,
      "date": "2024-01-01",
      "lost": 3
    }
  ]
}
```

### Get New/Lost Referring Domains — Daily Counts

#### Quickstart

Fetch a count history for a single target domain or URL. `output` is sent as a query parameter, and the required `target` goes in the JSON body.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `new_lost_refdomains_count` array. Each array item is an object with `new` and `lost` integer counts and a `date` string in `date` format.

```json
{
  "new_lost_refdomains_count": [
    {
      "new": 12,
      "date": "2024-01-01",
      "lost": 3
    }
  ]
}
```

### List Indexed Pages by Backlinks

#### Quickstart

Fetch indexed pages for a target site by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/indexed-pages?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `pages` array. Each item in `pages` is an object that may include `url` as a string, `backlinks` as an integer, and `refdomains` as an integer.

```json
{
  "pages": [
    {
      "url": "https://example.com/page-one",
      "backlinks": 42,
      "refdomains": 8
    }
  ]
}
```

### List Indexed Pages by Backlinks

#### Quickstart

Fetch indexed pages for a target site by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/indexed-pages?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `pages` array. Each item in `pages` is an object that may include `url` as a string, `backlinks` as an integer, and `refdomains` as an integer.

```json
{
  "pages": [
    {
      "url": "https://example.com/page-one",
      "backlinks": 42,
      "refdomains": 8
    }
  ]
}
```

### Get Domain Authority Distribution

#### Quickstart

Get the backlink authority distribution for a target domain, host, or URL.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain/distribution?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `distribution` array. Each item in `distribution` is an object with `domains`, `range_from`, and `range_to` integer fields.

```json
{
  "distribution": [
    {
      "domains": 12,
      "range_from": 0,
      "range_to": 10
    }
  ]
}
```

### Count Referring Domains

#### Quickstart

Get the number of referring domains for a target by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `refdomains` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "refdomains": 42
    }
  ]
}
```

### Count Referring Domains

#### Quickstart

Count referring domains for a target by sending the required `target` in the JSON body.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `refdomains` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "refdomains": 123
    }
  ]
}
```

### Get Raw Backlinks (Cursor-Paginated)

#### Quickstart

Fetch raw backlinks for a target URL or domain using the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/raw?target=example.com&mode=host" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `backlinks` array and an optional `next` string cursor for pagination. Each item in `backlinks` is an object describing one backlink record.

```json
{
  "next": "cursor-token",
  "backlinks": [
    {
      "url_from": "https://example.org/page",
      "url_to": "https://example.com/",
      "anchor": "Example site",
      "title": "Example Page",
      "nofollow": false,
      "first_seen": "2024-01-15",
      "last_visited": "2024-01-20",
      "inlink_rank": 42,
      "domain_inlink_rank": 18
    }
  ]
}
```

### List New/Lost Referring Domains

#### Quickstart

Fetch historical referring domains for a target by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `new_lost_refdomains` array. Each item in the array is an object that may include `backlinks`, `refdomain`, `first_seen`, `new_lost_date`, `new_lost_type`, `dofollow_backlinks`, and `domain_inlink_rank`.

```json
{
  "new_lost_refdomains": [
    {
      "backlinks": 12,
      "refdomain": "example.com",
      "first_seen": "2024-01-15",
      "new_lost_date": "2024-03-01",
      "new_lost_type": "new",
      "dofollow_backlinks": 10,
      "domain_inlink_rank": 42
    }
  ]
}
```

### List New/Lost Referring Domains

#### Quickstart

Fetch the history of new or lost referring domains for a target, using the required `target` field and the default JSON output.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains/history?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "example.com"
  }'
```

#### What you'll get back

Returns a JSON object with a `new_lost_refdomains` array. Each item in the array is an object with fields like `backlinks`, `refdomain`, `first_seen`, `new_lost_date`, `new_lost_type`, `dofollow_backlinks`, and `domain_inlink_rank`.

```json
{
  "new_lost_refdomains": [
    {
      "backlinks": 12,
      "refdomain": "refexample.com",
      "first_seen": "2024-01-10",
      "new_lost_date": "2024-01-15",
      "new_lost_type": "new",
      "dofollow_backlinks": 10,
      "domain_inlink_rank": 42
    }
  ]
}
```

### Get Page Authority

#### Quickstart

Look up backlink authority for a target URL. The `target` is required, and `output=json` is the default query format.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page?target=https://apyhub.com&output=json" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item in the array is an object with a `target` string and an `inlink_rank` integer.

```json
{
  "authority": [
    {
      "target": "https://example.com/page",
      "inlink_rank": 42
    }
  ]
}
```

### Get Page Authority

#### Quickstart

Look up authority data for a target backlink page and return it as JSON.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":["apyhub.com"]}'
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item in the array is an object with a `target` string and an `inlink_rank` integer.

```json
{
  "authority": [
    {
      "target": "https://example.com/page",
      "inlink_rank": 42
    }
  ]
}
```

### Get Domain Authority History

#### Quickstart

Fetch backlink authority history for a target domain with the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/domain/history?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `history` array. Each item in `history` is an object with a `date` string and a `domain_inlink_rank` integer.

```json
{
  "history": [
    {
      "date": "2024-01-01",
      "domain_inlink_rank": 42
    }
  ]
}
```

### List Referring Domains

#### Quickstart

Fetch referring domains for a target using the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `refdomains` array. Each item in the array can include `backlinks` (integer), `refdomain` (string), `first_seen` (date string), `dofollow_backlinks` (integer), and `domain_inlink_rank` (integer).

```json
{
  "refdomains": [
    {
      "backlinks": 42,
      "refdomain": "example.com",
      "first_seen": "2024-01-15",
      "dofollow_backlinks": 40,
      "domain_inlink_rank": 87
    }
  ]
}
```

### List Referring Domains

#### Quickstart

Get referring domains for a target site with the default JSON output.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/refdomains?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "example.com"
  }'
```

#### What you'll get back

Returns a JSON object with a `refdomains` array. Each item is an object that can include `backlinks`, `refdomain`, `first_seen`, `dofollow_backlinks`, and `domain_inlink_rank`.

```json
{
  "refdomains": [
    {
      "backlinks": 42,
      "refdomain": "example.org",
      "first_seen": "2024-01-15",
      "dofollow_backlinks": 38,
      "domain_inlink_rank": 7
    }
  ]
}
```

### Get Page & Domain Authority (Combined)

#### Quickstart

Get page and domain authority for a target URL by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority?target=https%3A%2F%2Fexample.com%2F" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item in the array is an object that can include `target` (string), `inlink_rank` (integer), and `domain_inlink_rank` (integer).

```json
{
  "authority": [
    {
      "target": "https://example.com/",
      "inlink_rank": 42,
      "domain_inlink_rank": 58
    }
  ]
}
```

### Get Page & Domain Authority (Combined)

#### Quickstart

Get authority metrics for a target URL or domain.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"https://example.com"}'
```

#### What you'll get back

Returns a JSON object with an `authority` array. Each item in the array is an object with `target` as a string, `inlink_rank` as an integer, and `domain_inlink_rank` as an integer.

```json
{
  "authority": [
    {
      "target": "https://example.com",
      "inlink_rank": 42,
      "domain_inlink_rank": 55
    }
  ]
}
```

### Get Cumulative Backlinks Over Time

#### Quickstart

Fetch cumulative backlink history for a target domain or URL using the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/cumulative?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `backlinks_count` array. Each item in the array is an object with a `date` string and a `backlinks` integer.

```json
{
  "backlinks_count": [
    {
      "date": "2024-01-01",
      "backlinks": 128
    }
  ]
}
```

### Get Cumulative Backlinks Over Time

#### Quickstart

Get cumulative backlink history for a target URL, domain, or host.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/cumulative?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `backlinks_count` array. Each item in the array is an object with a `date` string and a `backlinks` integer.

```json
{
  "backlinks_count": [
    {
      "date": "2024-01-01",
      "backlinks": 1234
    }
  ]
}
```

### List Backlink Anchor Texts

#### Quickstart

Fetch anchor text backlinks for a target URL or domain with the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/anchors?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with an `anchors` array. Each item in `anchors` is an object with fields like `anchor`, `backlinks`, `first_seen`, `refdomains`, `last_visited`, `dofollow_backlinks`, and `nofollow_backlinks`.

```json
{
  "anchors": [
    {
      "anchor": "example anchor",
      "backlinks": 12,
      "first_seen": "2024-01-15",
      "refdomains": 5,
      "last_visited": "2024-06-01",
      "dofollow_backlinks": 9,
      "nofollow_backlinks": 3
    }
  ]
}
```

### List Backlink Anchor Texts

#### Quickstart

Fetch backlink anchor data for a target domain, host, or URL.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/anchors?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with an `anchors` array. Each item in `anchors` is an object that can include `anchor`, `backlinks`, `first_seen`, `refdomains`, `last_visited`, `dofollow_backlinks`, and `nofollow_backlinks`.

```json
{
  "anchors": [
    {
      "anchor": "Example site",
      "backlinks": 12,
      "first_seen": "2024-01-15",
      "refdomains": 3,
      "last_visited": "2024-06-20",
      "dofollow_backlinks": 9,
      "nofollow_backlinks": 3
    }
  ]
}
```

### Get Backlink Profile Summary

#### Quickstart

Fetch backlink summary data for a target site. `mode` and `output` use their defaults, so only `target` is included.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/summary?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `summary` array. Each item in `summary` is an object containing backlink summary metrics such as `target`, `backlinks`, `refdomains`, `anchors`, `ips`, and related nested lists like `top_tlds`, `top_countries`, `top_pages_by_backlinks`, and `top_anchors_by_backlinks`.

```json
{
  "summary": [
    {
      "target": "example.com",
      "backlinks": 120,
      "refdomains": 45,
      "anchors": 18
    }
  ]
}
```

### Get Backlink Profile Summary

#### Quickstart

Fetch backlink summary data for a target domain or URL.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/summary?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "example.com",
    "mode": "host"
  }'
```

#### What you'll get back

Returns a JSON object with a `summary` array. Each item in the array is an object containing backlink metrics for a target, such as `target`, `backlinks`, `refdomains`, `anchors`, `ips`, `subnets`, and related top lists like `top_tlds`, `top_countries`, `top_pages_by_backlinks`, and `top_anchors_by_backlinks`.

```json
{
  "summary": [
    {
      "target": "example.com",
      "backlinks": 1234,
      "refdomains": 56,
      "anchors": 78
    }
  ]
}
```

### Get Backlink Metrics Overview

#### Quickstart

Look up backlink metrics for a target by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/metrics?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object that may include backlink counts and related totals for the requested target.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "backlinks": 0,
      "refdomains": 0,
      "ips": 0,
      "subnets": 0,
      "edu_backlinks": 0,
      "gov_backlinks": 0,
      "dofollow_backlinks": 0,
      "nofollow_backlinks": 0
    }
  ]
}
```

### Get Backlink Metrics Overview

#### Quickstart

Look up backlink metrics for a single target and return the result as JSON.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/metrics?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with fields like `target`, `backlinks`, `refdomains`, `ips`, `subnets`, `edu_backlinks`, `gov_backlinks`, `dofollow_backlinks`, and `nofollow_backlinks`.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "backlinks": 123,
      "refdomains": 45,
      "ips": 12,
      "subnets": 8,
      "edu_backlinks": 2,
      "gov_backlinks": 1,
      "dofollow_backlinks": 100,
      "nofollow_backlinks": 23
    }
  ]
}
```

### List Backlinks (Filtered)

#### Quickstart

Fetch backlinks for a target site by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/all?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `backlinks` array. Each item in the array is an object that may include fields like `url_from`, `url_to`, `anchor`, `title`, `nofollow`, `inlink_rank`, `domain_inlink_rank`, and date strings such as `first_seen` and `last_visited`.

```json
{
  "backlinks": [
    {
      "url_from": "https://blog.example.com/post-1",
      "url_to": "https://example.com/",
      "anchor": "Example",
      "nofollow": false,
      "inlink_rank": 42,
      "domain_inlink_rank": 58,
      "first_seen": "2024-01-12",
      "last_visited": "2024-02-03"
    }
  ]
}
```

### List Backlinks (Filtered)

#### Quickstart

Fetch backlinks for a target URL or domain. This example uses the required `target` field and the default `output=json`.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/all?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"https://example.com"}'
```

#### What you'll get back

Returns a JSON object with a `backlinks` array. Each item in `backlinks` is an object that may include fields such as `url_from`, `url_to`, `anchor`, `title`, `alt`, `image`, `nofollow`, `first_seen`, `last_visited`, `inlink_rank`, and `domain_inlink_rank`.

```json
{
  "backlinks": [
    {
      "url_from": "https://blog.example.org/post",
      "url_to": "https://example.com",
      "anchor": "Example site",
      "nofollow": false,
      "first_seen": "2024-01-15",
      "inlink_rank": 42
    }
  ]
}
```

### Count Total Backlinks

#### Quickstart

Fetch the backlink count for a target by passing it as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `backlinks` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "backlinks": 1234
    }
  ]
}
```

### Count Total Backlinks

#### Quickstart

Count backlinks for a single target by posting its `target` in JSON, with the result format set in the query string.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `backlinks` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "backlinks": 42
    }
  ]
}
```

### List New/Lost Backlinks

#### Quickstart

Fetch backlink history for a target host, domain, or URL using the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `new_lost_backlinks` array field. Each item in the array is an object describing a backlink history record, with fields such as `url_from`, `url_to`, `new_lost_date`, `new_lost_type`, and related backlink metadata.

```json
{
  "new_lost_backlinks": [
    {
      "url_from": "https://example.com/article",
      "url_to": "https://targetsite.com/page",
      "new_lost_date": "2024-01-15",
      "new_lost_type": "new"
    }
  ]
}
```

### List New/Lost Backlinks

#### Quickstart

Fetch backlink history for a target site or URL.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target":"https://example.com","mode":"url"}'
```

#### What you'll get back

Returns a JSON object with a `new_lost_backlinks` array. Each item in the array is an object describing one backlink record, with fields such as `url_from`, `url_to`, `anchor`, `first_seen`, `new_lost_date`, `new_lost_type`, and other backlink metadata.

```json
{
  "new_lost_backlinks": [
    {
      "url_from": "https://example.com/page-a",
      "url_to": "https://example.com",
      "anchor": "Example",
      "first_seen": "2024-01-01",
      "new_lost_date": "2024-01-15",
      "new_lost_type": "new"
    }
  ]
}
```

### Get Page Authority History

#### Quickstart

Get backlink authority history for a target URL or domain by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/authority/page/history?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `history` array. Each item in `history` is an object with a `date` string and an `inlink_rank` integer.

```json
{
  "history": [
    {
      "date": "2024-01-01",
      "inlink_rank": 42
    }
  ]
}
```

### Get New/Lost Backlinks — Daily Counts

#### Quickstart

Fetch backlink history counts for a target by passing the required `target` query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `new_lost_backlinks_count` array. Each array item is an object that may include `new` and `lost` integers plus a `date` string in `YYYY-MM-DD` format.

```json
{
  "new_lost_backlinks_count": [
    {
      "date": "2024-01-01",
      "new": 12,
      "lost": 3
    }
  ]
}
```

### Get New/Lost Backlinks — Daily Counts

#### Quickstart

Get backlink history counts for a target domain, host, or URL.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/history/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "example.com"
  }'
```

#### What you'll get back

Returns a JSON object with a `new_lost_backlinks_count` array. Each array item is an object with `new` (integer), `date` (string date), and `lost` (integer).

```json
{
  "new_lost_backlinks_count": [
    {
      "new": 12,
      "date": "2024-01-01",
      "lost": 3
    }
  ]
}
```

### Count Referring IPs

#### Quickstart

Check the number of referring IPs for a target by passing it as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips/count?target=example.com" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `referring_ips` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "referring_ips": 42
    }
  ]
}
```

### Count Referring IPs

#### Quickstart

Count the referring IPs for one target by sending its mode and target in a JSON body.

```bash
curl -X POST "https://api.eu.apyhub.com/se-ranking/backlinks/v1/backlinks/referring-ips/count?output=json" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"domain","target":"example.com"}'
```

#### What you'll get back

Returns a JSON object with a `metrics` array. Each item in `metrics` is an object with a `target` string and a `referring_ips` integer.

```json
{
  "metrics": [
    {
      "target": "example.com",
      "referring_ips": 42
    }
  ]
}
```

## About

## What it does
Backlinks Analyzer helps you inspect the backlink profile of a domain, host, or URL. Send a target and get counts, referring domains, referring IPs, anchor text breakdowns, authority scores, and backlink history back in JSON or XML.

Use it to measure link acquisition, audit backlink quality, or compare pages during SEO reviews. The service supports both single targets and batch requests on several endpoints, so you can pull summary metrics for a site, then drill into the exact backlinks, refdomains, anchors, and indexed pages that make up those totals.

You can also filter results by mode, limit, ordering, date range, dofollow or nofollow status, link type, anchor type, and URL patterns on the history and all-backlinks endpoints. For larger exports, the API returns a task ID and task status so you can poll for completion and download the generated `.csv.gz` file when it is ready.

Backlinks Analyzer is a fit for SEO dashboards, competitive analysis, link monitoring, and automated reporting where you need structured backlink data instead of manual exports.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/se-ranking/service/backlinks