> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Backlinks Summary

> Configure a workflow step that returns a backlink profile for a domain or page

Use **Backlinks Summary** when you want one profile for a domain, subdomain, or page: rank, backlink count, referring domains, spam score, and breakdowns by link type, location, and country. The step returns one object, not a list of links.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Target | Yes | A domain or subdomain without `https://` or `www.`, or a full page URL starting with `https://`. This field supports workflow variables through **Insert Variable**. |
| Link status | No | **Live** returns links found on the last check. **Lost** returns links that were removed. **All** returns both. Defaults to **Live**. |
| Include subdomains | No | When on, subdomains of the target are included. On by default. |
| Include indirect links | No | When on, indirect links are included. On by default. |
| Exclude internal backlinks | No | When on, links from the target's own subdomains are left out. On by default. |
| Breakdown list limit | No | How many entries to keep in each breakdown, such as top-level domains, link types, attributes, platforms, and page locations. From 1 to 1000. Defaults to 10. This does not change the internal-link count. |
| Rank scale | No | **0–1000** or **0–100**. Defaults to **0–1000**. |
| Filters | No | Up to 8 filter rows joined by **AND** or **OR**. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Add this step from the **Research** group in **Search steps...**.

A value with no scheme, such as `example.com`, is sent as a domain. `www.` is removed. A URL with a real path, such as `https://example.com/blog/post`, is sent as a page. `https://example.com/` is treated as the domain `example.com`. A path without `https://`, such as `example.com/blog`, is rejected.

## Output

Click **Run** in the step header to test the step. Fetch Hive shows the profile in **Output** after the run completes.

Use the variable picker in a later step to insert the exact output path available for that run. The base reference is:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

The output is one object. It includes `target`, `rank`, `backlinks`, `referring_domains`, `backlinks_spam_score`, and an `info` object with `target_spam_score`. It also includes counts for referring pages, IPs, and broken links, plus breakdowns such as `referring_links_tld` and `referring_links_countries`. To use the referring-domain count and the target spam score:

```text theme={null}
{{step_2.output.referring_domains}}
{{step_2.output.info.target_spam_score}}
```

There is no `items` or `results` list on this step. Use **Backlinks Search** when you need the individual links.

## Example

Add **Backlinks Summary** from the **Research** group in **Search steps...**.

Set **Name** to something like `Domain authority`.

Enter `example.com` in **Target**, or insert a variable that resolves to a domain or page URL. Leave **Link status** on **Live**, then click **Run** and review the profile in **Output** before using fields in a later step.

## Cost

Hosted runs convert the recorded service cost plus a 6% service fee into task credits. The charge is per request. It does not grow with a row count. See [Task costs](../../../resources/task-costs).

## Notes

* If the provider rejects the target or a filter, the step fails and the error message is the provider's message. **When the step fails** then decides whether the workflow stops or continues.
* Personal model keys are not used. This step always runs as a hosted provider call.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.