# Get the authority metrics of a URL or domain

Returns the rank, backlink count and linking domain count of each domain or URL you send. Use it to compare authority across many targets in one call.

Tool `web.url.metrics` 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.url.metrics/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"targets":["moz.com","ahrefs.com"]}}'
```

Python:

```python
import os

import httpx

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

TypeScript:

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

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "web.url.metrics",
    "input": {
      "targets": [
        "moz.com",
        "ahrefs.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 |
| --- | --- | --- | --- | --- |
| `targets` | array of string | Yes |  | Domains or subdomains, without scheme or www, such as "moz.com", or full URLs of pages. Each item: 1 or more characters. 1 to 50 items. No item twice. |

## 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 |
| --- | --- | --- | --- |
| `target` | string | Yes | The target as it was asked for. |
| `rank` | integer | No | Authority of the target from its backlinks, from 0 to 100, the domain's for a domain and the page's for a URL. Each provider computes its own; scores of different providers do not compare. |
| `backlink_count` | integer | No | Links to the target from other sites. |
| `linking_domain_count` | integer | No | Domains that link to the target. |

## Example output

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

```json
{
  "results": [
    {
      "target": "moz.com",
      "rank": 75,
      "backlink_count": null,
      "linking_domain_count": null
    },
    {
      "target": "ahrefs.com",
      "rank": 82,
      "backlink_count": null,
      "linking_domain_count": null
    }
  ]
}
```