# List the backlinks pointing to a target

Returns the backlinks pointing to a domain or page, with source page, anchor, link type and dates. Use it to audit a site's links.

Tool `web.backlinks.list` on Open web and SEO. Contract version 1, released 2026-10-27.

## Example call

Over REST, send the input in the body. Over MCP, pass the same input to `call_tool`.

cURL:

```bash
curl https://api.voxoria.ai/v1/tools/web.backlinks.list/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"target":"moz.com"}}'
```

Python:

```python
import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/web.backlinks.list/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"target": "moz.com"}},
    timeout=60,
)
print(response.json())
```

TypeScript:

```ts
const response = await fetch("https://api.voxoria.ai/v1/tools/web.backlinks.list/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"target": "moz.com"}}),
});
console.log(await response.json());
```

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "web.backlinks.list",
    "input": {
      "target": "moz.com"
    }
  }
}
```

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `target` | string | Yes |  | The domain or subdomain, without scheme or www, such as "moz.com", or the full URL of one page. 1 or more characters. |
| `link_status` | string | No | `live` | Which backlinks to list: live (still on the linking page), lost (gone from it, or the page itself gone) or all. One of `live`, `lost`, `all`. |
| `page` | integer | No | `1` | Page of results, page_size per page. The strongest links come first, by the provider's own measure. At least 1. |
| `page_size` | integer | No | `10` | Results per page. Each result adds to the price of the call. From 1 to 100. |

## Output

A successful call returns these blocks in its `output`. A field not marked required can be `null`.

### results

A list of rows. Always present, possibly empty.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `source_url` | string | Yes | Address of the page the link is on. |
| `source_domain` | string | No | Domain of the page the link is on. |
| `source_title` | string | No | Title of the page the link is on. |
| `target_url` | string | Yes | Address the link points to. |
| `anchor` | string | No | Text of the link. Absent for an image link. |
| `link_type` | string | No | How the page links: text (an ordinary link), image (a linked image), redirect, canonical or alternate (a link element in the page head). One of `text`, `image`, `redirect`, `canonical`, `alternate`. |
| `dofollow` | boolean | No | Whether the link passes ranking credit, having no nofollow attribute. |
| `source_page_rank` | integer | No | Authority of the linking page from its own backlinks, from 0 to 100. Each provider computes its own; scores of different providers do not compare. |
| `source_domain_rank` | integer | No | Authority of the linking domain from its own backlinks, from 0 to 100. Each provider computes its own; scores of different providers do not compare. |
| `first_seen_at` | string | No | When the link was first found, as an ISO 8601 timestamp in UTC. |
| `last_seen_at` | string | No | When the link was last found, as an ISO 8601 timestamp in UTC. |
| `lost` | boolean | No | Whether the link is gone from the page, or the page itself is gone. |

## Example output

The `output` of a real call, each list cut to 3 items.

```json
{
  "results": [
    {
      "source_url": "https://nodebb.org/",
      "source_domain": "nodebb.org",
      "source_title": "NodeBB - Modern Forum Software",
      "target_url": "https://moz.com/community/q/",
      "anchor": null,
      "link_type": "image",
      "dofollow": true,
      "source_page_rank": 94,
      "source_domain_rank": 80,
      "first_seen_at": "2025-05-04T21:25:18Z",
      "last_seen_at": "2026-10-06T11:31:48Z",
      "lost": false
    },
    {
      "source_url": "https://vii120.coderbridge.io/2020/11/18/html-rel/",
      "source_domain": "vii120.coderbridge.io",
      "source_title": "[html] 暗藏玄機的跨域連結 - link rel",
      "target_url": "https://moz.com/learn/seo/backlinks",
      "anchor": "Backlinks | SEO Best Practices [2020] - Moz",
      "link_type": "text",
      "dofollow": true,
      "source_page_rank": 93,
      "source_domain_rank": 82,
      "first_seen_at": "2025-04-24T11:51:30Z",
      "last_seen_at": "2026-01-02T08:23:30Z",
      "lost": false
    },
    {
      "source_url": "https://arzaanservice1.ir/seo/",
      "source_domain": "arzaanservice1.ir",
      "source_title": "خرید بک لینک ،خرید رپرتاژ خبری ،خرید بک لینک ،طراحی وب سایت، سئو سایت",
      "target_url": "https://moz.com/",
      "anchor": "moz",
      "link_type": "text",
      "dofollow": true,
      "source_page_rank": 85,
      "source_domain_rank": 74,
      "first_seen_at": "2023-08-25T01:04:58Z",
      "last_seen_at": "2026-10-05T13:28:44Z",
      "lost": false
    }
  ]
}
```