> ## 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.

# List domain baseline candidates

> Page baseline candidates.

`list_domain_baseline_candidates`

Page baseline candidates. Retains source provenance and exact baseline/discovery identities. Defaults to 25 rows, maximum 100 and 64 KiB. Continue using the scoped cursor. Indexed status is not an independent check.

<Note>Development preview. This command is absent from the verified deployed bundle. Use a matching development environment.</Note>

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

This read does not start a verification job.

## Example request

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

<CodeGroup>
  ```json MCP theme={null}
  {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_domain_baseline_candidates",
      "arguments": {
        "runId": "bl_fixture_ready",
        "limit": 25
      }
    }
  }
  ```

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

  ```bash HTTP theme={null}
  curl "$AGENTLINKOPS_API_URL/v1/commands/list_domain_baseline_candidates" \
    -H "Authorization: Bearer $AGENTLINKOPS_API_KEY" \
    -H 'Content-Type: application/json' \
    --data '{"runId":"bl_fixture_ready","limit":25}'
  ```
</CodeGroup>

## Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in `structuredContent` and in a text content block; generic HTTP and CLI return the JSON result directly.

<Accordion title="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"
    },
    "items": [
      {
        "v": 1,
        "id": "dc_bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
        "workspace_id": "ws_example",
        "project_id": "pr_example",
        "discovery_run_id": "bl_fixture_ready",
        "source_url": "https://publisher.example.org/article",
        "target_url": "https://example.com/",
        "provider": "linktrail_corpus",
        "data_mode": "owned_corpus",
        "provider_retrieved_at": "2026-09-13T12:00:00.000Z",
        "provider_first_seen": "2026-09-13T12:00:00.000Z",
        "provider_prev_seen": null,
        "provider_last_seen": "2026-09-13T12:00:00.000Z",
        "provider_status": {
          "is_lost": null,
          "is_broken": null,
          "is_new": null
        },
        "anchor": "Example",
        "rel": [],
        "dofollow": true,
        "link_type": "anchor",
        "source_http_status": 200,
        "target_http_status": null,
        "links_count": 1,
        "provider_metrics": {
          "linktrail_corpus": {
            "source_outlink_count": 1,
            "source_external_outlink_count": 1,
            "fetch_kind": "direct",
            "extraction_complete": true
          }
        },
        "verification_status": "not_checked",
        "verified_at": null,
        "observation_id": null
      }
    ],
    "has_more": false,
    "next_cursor": null,
    "truncated": false,
    "snapshot": {
      "through_provider_page": 0,
      "refresh_from_start_for_new_results": true
    }
  }
  ```
</Accordion>

## Input fields

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

| Field | Type | Presence | Meaning and constraints |
| - | - | - | - |
| `runId` | string | Required | Identifier of the run returned by its create or list operation. pattern: "^\[a-zA-Z0-9\_-]\{1,128}\$" |
| `limit` | integer | Optional | Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 100; default: 25 |
| `cursor` | string | Optional | Opaque continuation returned by this same listing; omit for the first page. maxLength: 1024 |

### Validation and omitted values

Supplier admission remains disabled. Synthetic development results do not establish provider coverage.

Saved baseline identity and exact website scope survive retries. Indexed candidates, one-off observations and explicitly selected recurring monitors remain separate.

### Defaults when omitted

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

## Output fields

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

* **`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
* **`coverage`** (object, required): Dataset scope and completeness, including limits on what these results establish. additional fields rejected
* **`items`** (array, required): Records in this bounded page. maxItems: 100
* **`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.
* **`truncated`** (boolean, required).
* **`snapshot`** (object, required): additional fields rejected

<Accordion title="All fields and nested objects">
  | Field | Type | Presence | Meaning and constraints |
  | - | - | - | - |
  | `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 | True: the rendered preview uses example content, never customer events. must equal true |
  | `coverage.ordering` | string | Required | must equal "rank,desc" |
  | `coverage.reason` | string / null | Required | Recorded explanation; null when no explanation applies. |
  | `items` | array | Required | Records in this bounded page. maxItems: 100 |
  | `items[].v` | number | Required | must equal 1 |
  | `items[].id` | string | Required | Resource identifier returned by the operation. pattern: "^dc\_\[a-f0-9]\{64}\$" |
  | `items[].workspace_id` | string | Required | Workspace that owns this record. minLength: 1; maxLength: 128; pattern: "^\[a-zA-Z0-9\_-]+\$" |
  | `items[].project_id` | string | Required | Project that owns this record. minLength: 1; maxLength: 128; pattern: "^\[a-zA-Z0-9\_-]+\$" |
  | `items[].discovery_run_id` | string | Required | Identifier returned by the related operation. minLength: 1; maxLength: 128; pattern: "^\[a-zA-Z0-9\_-]+\$" |
  | `items[].source_url` | string | Required | Publisher page URL recorded in this evidence. maxLength: 4096 |
  | `items[].target_url` | string | Required | Destination URL recorded in this evidence. maxLength: 4096 |
  | `items[].provider` | string | Required | values: "linktrail\_corpus", "dataforseo", "imported" |
  | `items[].data_mode` | string | Required | values: "synthetic", "owned\_corpus", "provider\_index", "imported" |
  | `items[].provider_retrieved_at` | string | Required | Timestamp when the upstream evidence was retrieved. format: "date-time"; pattern: "^(?:(?:\d\d\[2468]\[048]\|\d\d\[13579]\[26]\|\d\d0\[48]\|\[02468]\[048]00\|\[13579]\[26]00)-02-29\|\d\{4}-(?:(?:0\[13578]\|1\[02])-(?:0\[1-9]\|\[12]\d\|3\[01])\|(?:0\[469]\|11)-(?:0\[1-9]\|\[12]\d\|30)\|(?:02)-(?:0\[1-9]\|1\d\|2\[0-8])))T(?:(?:\[01]\d\|2\[0-3]):\[0-5]\d:\[0-5]\d\\.\d\{3}(?:Z))\$" |
  | `items[].provider_first_seen` | string / null | Required | |
  | `items[].provider_prev_seen` | string / null | Required | |
  | `items[].provider_last_seen` | string / null | Required | |
  | `items[].provider_status` | object | Required | additional fields rejected |
  | `items[].provider_status.is_lost` | boolean / null | Required | |
  | `items[].provider_status.is_broken` | boolean / null | Required | |
  | `items[].provider_status.is_new` | boolean / null | Required | |
  | `items[].anchor` | string / null | Required | |
  | `items[].rel` | array / null | Required | |
  | `items[].dofollow` | boolean / null | Required | |
  | `items[].link_type` | string / null | Required | |
  | `items[].source_http_status` | integer / null | Required | |
  | `items[].target_http_status` | integer / null | Required | |
  | `items[].links_count` | integer / null | Required | |
  | `items[].provider_metrics` | object / object / object | Required | |
  | `items[].provider_metrics.dataforseo` | object | Required | additional fields rejected |
  | `items[].provider_metrics.dataforseo.rank` | integer / null | Required | |
  | `items[].provider_metrics.dataforseo.page_from_rank` | integer / null | Required | |
  | `items[].provider_metrics.dataforseo.domain_from_rank` | integer / null | Required | |
  | `items[].provider_metrics.dataforseo.backlink_spam_score` | integer / null | Required | |
  | `items[].provider_metrics.dataforseo.rank_scale` | string | Required | must equal "one\_thousand" |
  | `items[].provider_metrics.imported` | object | Required | additional fields rejected |
  | `items[].provider_metrics.imported.supplier` | string | Required | values: "ahrefs", "google\_search\_console", "bing\_webmaster\_tools", "semrush", "majestic", "moz", "dataforseo", "linkody", "csv" |
  | `items[].provider_metrics.imported.supplier_row_id` | string / null | Required | Identifier returned by the related operation. |
  | `items[].provider_metrics.imported.supplier_generated_at` | string / null | Required | |
  | `items[].provider_metrics.imported.supplier_metrics` | object / null | Required | |
  | `items[].provider_metrics.linktrail_corpus` | object | Required | additional fields rejected |
  | `items[].provider_metrics.linktrail_corpus.source_outlink_count` | integer / null | Required | |
  | `items[].provider_metrics.linktrail_corpus.source_external_outlink_count` | integer / null | Required | |
  | `items[].provider_metrics.linktrail_corpus.fetch_kind` | string | Required | values: "direct", "rendered", "proxied" |
  | `items[].provider_metrics.linktrail_corpus.extraction_complete` | boolean | Required | |
  | `items[].verification_status` | string | Required | AgentLinkOps check state, independent of supplier flags. not\_checked means no AgentLinkOps check is recorded. values: "not\_checked", "present", "absent", "unknown", "source\_unavailable" |
  | `items[].verified_at` | string / null | Required | Timestamp of the AgentLinkOps check; null until checked. |
  | `items[].observation_id` | string / null | Required | Identifier returned by the related operation. |
  | `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. |
  | `truncated` | boolean | Required | |
  | `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 |
</Accordion>

[Download input schema](/schemas/list_domain_baseline_candidates.input.json) · [Download output schema](/schemas/list_domain_baseline_candidates.output.json)

## Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict.

See [error recovery](/reference/errors) 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

[get\_domain\_baseline](/reference/commands/get_domain_baseline) · [list\_domain\_baseline\_candidates](/reference/commands/list_domain_baseline_candidates)

Follow the [related workflow](/guides/import-and-verify), inspect [capability status](/capability-status), or return to the [command index](/reference/index).


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