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

# Group domain baseline results

> Group a finished baseline by referring site or anchor text.

`list_domain_baseline_groups`

Group a finished baseline by referring site or anchor text. Counts, share of rows, check results, retained scores and an anchor-pattern review signal over the retained set. Never a disavow decision, supplier call, check or monitor.

> [!NOTE]
>
> Hosted availability unverified: this name is absent from the 2026-10-27 deployment evidence. Check your connected catalog before calling. Provider configuration and workspace access still apply.

| Access | Behavior |
| - | - |
| `discovery:read`, `watches:read` | Reads saved data |

This read does not start a verification job.

## Example request

Connect through [MCP](https://docs.agentlinkops.com/guides/connect-mcp.md), [CLI](https://docs.agentlinkops.com/guides/connect-cli.md), or [HTTP](https://docs.agentlinkops.com/guides/connect-http.md). Replace example identifiers with records from your workspace.

```json MCP theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_domain_baseline_groups",
    "arguments": {
      "runId": "bl_fixture_ready",
      "by": "referring_site",
      "limit": 25
    }
  }
}
```

```bash CLI theme={null}
agentlinkops call list_domain_baseline_groups --args '{"runId":"bl_fixture_ready","by":"referring_site","limit":25}'
```

```bash HTTP theme={null}
curl --fail-with-body https://app.agentlinkops.com/v1/commands/list_domain_baseline_groups \
  -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"runId":"bl_fixture_ready","by":"referring_site","limit":25}'
```

## Returned result

Schema-validated example; IDs and dates are illustrative. MCP returns this data in `structuredContent` and in a text content block; generic HTTP and CLI return the JSON result directly.

> [accordion] Full response example
>
> ```json theme={null}
> {
>   "schema_version": 1,
>   "baseline_run_id": "bl_fixture_ready",
>   "discovery_run_id": "bl_fixture_ready",
>   "scope": {
>     "domain": "example.com",
>     "include_subdomains": true,
>     "website_revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
>     "query_version": "dataforseo-as-is-v1"
>   },
>   "coverage": {
>     "whole_web": false,
>     "sample": true,
>     "ordering": "rank,desc",
>     "reason": "row_limit"
>   },
>   "by": "referring_site",
>   "items": [
>     {
>       "key": "publisher.example",
>       "site": "publisher.example",
>       "links": 1,
>       "live": 1,
>       "not_found": 0,
>       "couldnt_check": 0,
>       "not_checked": 0,
>       "dofollow": 1,
>       "nofollow": 0,
>       "monitored": 0,
>       "share": 1,
>       "authority": null,
>       "spam": null,
>       "first_seen": null,
>       "anchors": 1,
>       "top_anchor": "example anchor"
>     }
>   ],
>   "has_more": false,
>   "next_cursor": null,
>   "total": 1,
>   "truncated": false,
>   "review": {
>     "filters": {},
>     "retrieved": 1,
>     "matched": 1,
>     "previous_baseline_run_id": null,
>     "previous_search_at": null,
>     "previous_search_rows": null
>   },
>   "anchor_pattern": null,
>   "snapshot": {
>     "through_provider_page": 0,
>     "refresh_from_start_for_new_results": true
>   }
> }
> ```

## Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

* **`browse`** (boolean, optional): Server-sorted authorized saved rows; omit for legacy paging.
* **`sort`** (string, optional): Allowlisted saved-field identifier. minLength: `1`; maxLength: `80`
* **`order`** (string, optional): Sort direction; stable ID ties, nulls last. values: `"asc"`, `"desc"`
* **`q`** (string, optional): Literal search of supported saved fields. maxLength: `500`
* **`table_filters`** (string / array, optional): Up to 12 allowlisted column filters before paging.
* **`runId`** (string, required): run ID from create/list. pattern: `"^[a-zA-Z0-9_-]{1,128}$"`
* **`by`** (string, required): Group by linking site or by anchor text. values: `"referring_site"`, `"anchor"`
* **`limit`** (integer, optional): Page/report row cap; see bounds. minimum: `1`; maximum: `100`; default: `25`
* **`cursor`** (string, optional): Opaque list cursor; omit initially. minLength: `1`; maxLength: `16384`
* **`follow`** (string, optional): Followed or nofollow, as the backlink index reported it. values: `"dofollow"`, `"nofollow"`
* **`check`** (string, optional): Latest check result of the row. values: `"live"`, `"not_found"`, `"couldnt_check"`, `"not_checked"`
* **`minAuthority`** (integer, optional): Minimum retained domain strength (0-1,000). Rows without a score are excluded. minimum: `0`; maximum: `1000`
* **`maxSpam`** (integer, optional): Maximum retained spam risk (0-100). Rows without a score are excluded. minimum: `0`; maximum: `100`
* **`newSinceLastSearch`** (boolean, optional): Only rows absent from the previous finished search of this website.
* **`site`** (string, optional): One referring site (host without www). minLength: `1`; maxLength: `253`
* **`anchor`** (string, optional): Anchor text, compared normalized; empty matches rows without anchor text. maxLength: `4096`

> [accordion] All fields and nested objects
>
> Types, allowed values, limits and nested fields:
>
> | Field | Type | Presence | Meaning and constraints |
> | - | - | - | - |
> | `browse` | boolean | Optional | Server-sorted authorized saved rows; omit for legacy paging. |
> | `sort` | string | Optional | Allowlisted saved-field identifier. minLength: `1`; maxLength: `80` |
> | `order` | string | Optional | Sort direction; stable ID ties, nulls last. values: `"asc"`, `"desc"` |
> | `q` | string | Optional | Literal search of supported saved fields. maxLength: `500` |
> | `table_filters` | string / array | Optional | Up to 12 allowlisted column filters before paging. |
> | `table_filters[].column` | string | Required | minLength: `1`; maxLength: `80` |
> | `table_filters[].operator` | string | Required | values: `"contains"`, `"is"`, `"is_not"`, `"empty"` |
> | `table_filters[].value` | string | Required | maxLength: `500` |
> | `runId` | string | Required | run ID from create/list. pattern: `"^[a-zA-Z0-9_-]{1,128}$"` |
> | `by` | string | Required | Group by linking site or by anchor text. values: `"referring_site"`, `"anchor"` |
> | `limit` | integer | Optional | Page/report row cap; see bounds. minimum: `1`; maximum: `100`; default: `25` |
> | `cursor` | string | Optional | Opaque list cursor; omit initially. minLength: `1`; maxLength: `16384` |
> | `follow` | string | Optional | Followed or nofollow, as the backlink index reported it. values: `"dofollow"`, `"nofollow"` |
> | `check` | string | Optional | Latest check result of the row. values: `"live"`, `"not_found"`, `"couldnt_check"`, `"not_checked"` |
> | `minAuthority` | integer | Optional | Minimum retained domain strength (0-1,000). Rows without a score are excluded. minimum: `0`; maximum: `1000` |
> | `maxSpam` | integer | Optional | Maximum retained spam risk (0-100). Rows without a score are excluded. minimum: `0`; maximum: `100` |
> | `newSinceLastSearch` | boolean | Optional | Only rows absent from the previous finished search of this website. |
> | `site` | string | Optional | One referring site (host without www). minLength: `1`; maxLength: `253` |
> | `anchor` | string | Optional | Anchor text, compared normalized; empty matches rows without anchor text. maxLength: `4096` |

### Validation and omitted values

Reads only the rows a finished search already retained: no supplier call, check, credit or monitor. While a search is queued, fetching or checking, it returns BASELINE\_REVIEW\_NOT\_READY; unfiltered list\_domain\_baseline\_candidates pages stay readable during a run.

Groups by referring site (the linking host without www) or by normalized anchor text. Each group reports its links, its share of the rows read (all retained rows, or those that match the filters), check results, follow counts, monitored links and retained scores; a row without a score never passes a score filter.

anchor\_pattern names one anchor that is not empty, a web address, the website's own name (alone or followed by more words) or a generic phrase when it covers at least 20% of the rows from at least five sites. It is a review signal (review\_signal true, disavow\_recommended false), never a disavow decision.

newSinceLastSearch compares with the latest earlier search of the same website and subdomain setting whose link list completed, and returns BASELINE\_NO\_PREVIOUS\_SEARCH when there is none. review\.previous\_search\_rows gives how many rows that search kept. Both searches are index samples, so a row the earlier sample lacks is not proof that the link is new.

### Defaults when omitted

| Field | Default |
| - | - |
| `limit` | `25` |

## Output fields

Fields inside optional or nullable parents apply only when that parent exists. [Common schema conventions](https://docs.agentlinkops.com/reference/schemas.md) explain evidence states, empty lists and extensions.

* **`total`** (integer / null, optional).
* **`has_more`** (boolean, required): True when another page is available.
* **`next_cursor`** (string / null, required): Opaque continuation for the same listing; null means no further page.
* **`page`** (object, optional).
* **`schema_version`** (number / number, required).
* **`baseline_run_id`** (string, required): Identifier returned by the related operation.
* **`discovery_run_id`** (string, required): Identifier returned by the related operation.
* **`scope`** (object, required).
* **`coverage`** (object, required): Dataset scope and completeness, including limits on what these results establish.
* **`by`** (string, required).
* **`items`** (array, required): Records in this bounded page.
* **`truncated`** (boolean, required).
* **`review`** (object, required).
* **`anchor_pattern`** (object / null, required).
* **`snapshot`** (object, required).

> [accordion] All fields and nested objects
>
> Types, allowed values, limits and nested fields:
>
> | Field | Type | Presence | Meaning and constraints |
> | - | - | - | - |
> | `total` | integer / null | Optional | |
> | `has_more` | boolean | Required | True when another page is available. |
> | `next_cursor` | string / null | Required | Opaque continuation for the same listing; null means no further page. |
> | `page` | object | Optional | additional fields rejected |
> | `page.limit` | integer | Required | maximum: `9007199254740991`; exclusiveMinimum: `0` |
> | `page.sort` | string | Required | |
> | `page.order` | string | Required | values: `"asc"`, `"desc"` |
> | `page.total` | integer / null | Required | |
> | `page.query_scope` | string | Required | must equal `"server_dataset"` |
> | `page.nulls` | string | Required | must equal `"last"` |
> | `schema_version` | number / number | Required | |
> | `baseline_run_id` | string | Required | Identifier returned by the related operation. |
> | `discovery_run_id` | string | Required | Identifier returned by the related operation. |
> | `scope` | object | Required | additional fields rejected |
> | `scope.domain` | string | Required | minLength: `1`; maxLength: `253` |
> | `scope.include_subdomains` | boolean | Required | |
> | `scope.website_revision` | string | Required | pattern: `"^[a-f0-9]{64}$"` |
> | `scope.query_version` | string | Required | must equal `"dataforseo-as-is-v1"` |
> | `coverage` | object | Required | Dataset scope and completeness, including limits on what these results establish. additional fields rejected |
> | `coverage.whole_web` | boolean | Required | must equal `false` |
> | `coverage.sample` | boolean | Required | Whether the result is a sample. Read coverage for the limits of that sample. must equal `true` |
> | `coverage.ordering` | string | Required | must equal `"rank,desc"` |
> | `coverage.reason` | string / null | Required | Recorded explanation; null when no explanation applies. |
> | `by` | string | Required | values: `"referring_site"`, `"anchor"` |
> | `items` | array | Required | Records in this bounded page. maxItems: `100` |
> | `items[].key` | string | Required | Saved lookup identifier within this record. |
> | `items[].site` | string | Required | |
> | `items[].links` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].live` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].not_found` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].couldnt_check` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].not_checked` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].dofollow` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].nofollow` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].monitored` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].share` | number | Required | minimum: `0`; maximum: `1` |
> | `items[].authority` | integer / null | Required | |
> | `items[].spam` | integer / null | Required | |
> | `items[].first_seen` | string / null | Required | |
> | `items[].anchors` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `items[].top_anchor` | string / null | Required | |
> | `items[].anchor` | string | Required | |
> | `items[].anchor_kind` | string | Required | values: `"empty"`, `"url"`, `"brand"`, `"generic"`, `"text"` |
> | `items[].sites` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `truncated` | boolean | Required | |
> | `review` | object | Required | additional fields rejected |
> | `review.filters` | object | Required | additional fields rejected |
> | `review.filters.follow` | string | Optional | values: `"dofollow"`, `"nofollow"` |
> | `review.filters.check` | string | Optional | values: `"live"`, `"not_found"`, `"couldnt_check"`, `"not_checked"` |
> | `review.filters.minAuthority` | integer | Optional | minimum: `-9007199254740991`; maximum: `9007199254740991` |
> | `review.filters.maxSpam` | integer | Optional | minimum: `-9007199254740991`; maximum: `9007199254740991` |
> | `review.filters.newSinceLastSearch` | boolean | Optional | must equal `true` |
> | `review.filters.site` | string | Optional | |
> | `review.filters.anchor` | string | Optional | |
> | `review.retrieved` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `review.matched` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `review.previous_baseline_run_id` | string / null | Required | Identifier returned by the related operation. |
> | `review.previous_search_at` | string / null | Required | |
> | `review.previous_search_rows` | integer / null | Required | |
> | `anchor_pattern` | object / null | Required | |
> | `anchor_pattern.anchor` | string | Required | |
> | `anchor_pattern.anchor_normalized` | string | Required | |
> | `anchor_pattern.links` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `anchor_pattern.sites` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `anchor_pattern.share` | number | Required | minimum: `0`; maximum: `1` |
> | `anchor_pattern.rows` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `anchor_pattern.threshold` | object | Required | additional fields rejected |
> | `anchor_pattern.threshold.min_share` | number | Required | |
> | `anchor_pattern.threshold.min_sites` | integer | Required | minimum: `0`; maximum: `9007199254740991` |
> | `anchor_pattern.review_signal` | boolean | Required | must equal `true` |
> | `anchor_pattern.disavow_recommended` | boolean | Required | must equal `false` |
> | `snapshot` | object | Required | additional fields rejected |
> | `snapshot.through_provider_page` | number / null | Required | |
> | `snapshot.refresh_from_start_for_new_results` | boolean | Required | must equal `true` |

[Download input schema](https://docs.agentlinkops.com/schemas/list_domain_baseline_groups.input.json) · [Download output schema](https://docs.agentlinkops.com/schemas/list_domain_baseline_groups.output.json)

## Errors and retries

Follow the error recovery before retrying this read. Preserve the selected workspace, project, filters and feed. Recovering a read does not require an idempotency key or another verification job. Operation-specific errors include `BASELINE_REVIEW_NOT_READY`, `BASELINE_NO_PREVIOUS_SEARCH`, `DISCOVERY_REVIEW_TOO_LARGE`, `INVALID_CURSOR`.

See [error recovery](https://docs.agentlinkops.com/reference/errors.md) for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

## HTTP resource routes

This operation has no separate resource alias. Use its generic command route in a matching environment.

## Continue

[list\_domain\_baseline\_candidates](https://docs.agentlinkops.com/reference/commands/list_domain_baseline_candidates.md) · [monitor\_domain\_baseline\_candidates](https://docs.agentlinkops.com/reference/commands/monitor_domain_baseline_candidates.md)

Follow the [related workflow](https://docs.agentlinkops.com/guides/find-backlinks.md). See [capability status](https://docs.agentlinkops.com/capability-status.md) for availability or the [command index](https://docs.agentlinkops.com/reference/index.md) for another operation.


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