> ## 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.
# Get link profile
> Summarize monitored placements, source hosts, destinations and observed rel attributes.
`get_link_profile`
Summarize monitored placements, source hosts, destinations and observed rel attributes. Read coverage: this is your tracked dataset, not the whole web.
Hosted MCP registration verified. These schemas describe the development contract; confirm supported inputs with tools/list. Generic CLI/HTTP calls require a matching development server. Configure LINKTRAIL\_API\_URL; production does not expose these command routes.
| Access | Behavior |
| -------------- | ---------------- |
| `watches:read` | Reads saved data |
Reading saved data does not start a verification job. Mutations can change saved records or access; the effects below apply.
## 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.
```json MCP theme={null}
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_link_profile",
"arguments": {}
}
}
```
```bash CLI theme={null}
linktrail call get_link_profile --args '{}'
```
```bash HTTP theme={null}
curl "$LINKTRAIL_API_URL/v1/commands/get_link_profile" \
-H "Authorization: Bearer $LINKTRAIL_API_KEY" \
-H 'Content-Type: application/json' \
--data '{}'
```
## 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.
```json theme={null}
{
"schema_version": 1,
"workspace_id": "ws_example",
"project_id": null,
"status_filter": "all",
"generated_at": "2026-09-13T12:00:00.000Z",
"coverage": {
"denominator": "known_monitored_placements",
"whole_web_coverage": false,
"observation_basis": "latest_complete_successful_observation_per_watch",
"includes_paused": true,
"project_grant": "all_projects",
"watch_count": 0,
"scanned_watch_count": 0,
"eligible_present_watches_in_scan": 0,
"excluded_evidence_watches_in_scan": 0,
"available_occurrences_in_scan": 0,
"scanned_occurrence_count": 0,
"included_occurrence_count": 0,
"invalid_occurrence_count": 0,
"occurrence_payload_bytes": 0,
"watch_payload_bytes": 0,
"watch_scan_limit": 1000,
"occurrence_scan_limit": 5000,
"watch_payload_byte_limit": 2097152,
"occurrence_payload_byte_limit": 1048576,
"included_observation_oldest_at": null,
"included_observation_newest_at": null,
"partial": false,
"limitations": []
},
"analysis_partial": false,
"freshness": {
"oldest_last_success_at": null,
"newest_last_success_at": null,
"oldest_latest_attempt_at": null,
"newest_latest_attempt_at": null
},
"counting_notes": [
"Coverage is limited to the monitored placements in this workspace."
],
"counts": {
"watches": 0,
"status": {
"active": 0,
"paused": 0
},
"never_checked": 0,
"current_state": {
"present": 0,
"suspected_missing": 0,
"confirmed_missing": 0,
"source_unavailable": 0,
"unknown": 0
},
"latest_attempt": {
"present": 0,
"absent": 0,
"source_unavailable": 0,
"unknown": 0,
"evidence_unavailable": 0
},
"last_successful_observation": {
"present": 0,
"absent": 0,
"source_unavailable": 0,
"none": 0,
"evidence_unavailable": 0
},
"complete_present_evidence_in_scan": 0,
"known_present_after_unknown": 0
},
"monitored_source_hosts": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"monitored_targets": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"observed_referring_hosts": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"observed_targets": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"link_rel_sets": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"link_rel_tokens": {
"items": [],
"total_groups": 0,
"returned_groups": 0,
"truncated": false
},
"rel_facts": {
"included_occurrences": 0,
"no_link_nofollow_token_occurrences": 0,
"page_nofollow_occurrences": 0,
"ranking_credit_inferred": false
}
}
```
## 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 |
| ----------- | ------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `projectId` | string | Optional | Identifier of the project returned by its create or list operation. minLength: 1; maxLength: 200 |
| `status` | string | Optional | Lifecycle status filter or requested status; this is separate from observation state. default: "all"; values: "all", "active", "paused" |
| `limit` | integer | Optional | Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 100; default: 50 |
### Validation and omitted values
Omitting projectId reads the accessible workspace scope rather than selecting a different project.
These are bounded reports, not cursor-paginated exports. The report limit bounds returned groups; retained dataset coverage and truncation remain explicit. Omitted projectId includes records allowed by the credential.
### Defaults when omitted
| Field | Default |
| -------- | ------- |
| `status` | `"all"` |
| `limit` | `50` |
## 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.
| Field | Type | Presence | Meaning and constraints |
| --------------------------------------------------------- | ------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| `schema_version` | number | Required | schema version recorded for this result. |
| `workspace_id` | string | Required | Workspace that owns this record. |
| `project_id` | string / null | Required | Project that owns this record. |
| `status_filter` | string | Required | status filter recorded for this result. |
| `generated_at` | string | Required | generated at recorded for this result. |
| `coverage` | object | Required | Dataset scope and completeness, including limits on what these results establish. |
| `coverage.denominator` | string | Required | denominator recorded for this result. |
| `coverage.whole_web_coverage` | boolean | Required | False: these results do not measure the whole web. must equal false |
| `coverage.observation_basis` | string | Required | observation basis recorded for this result. |
| `coverage.includes_paused` | boolean | Required | includes paused recorded for this result. |
| `coverage.project_grant` | string | Required | project grant recorded for this result. |
| `coverage.watch_count` | number | Required | watch count recorded for this result. |
| `coverage.scanned_watch_count` | number | Required | scanned watch count recorded for this result. |
| `coverage.eligible_present_watches_in_scan` | number | Required | eligible present watches in scan recorded for this result. |
| `coverage.excluded_evidence_watches_in_scan` | number | Required | excluded evidence watches in scan recorded for this result. |
| `coverage.available_occurrences_in_scan` | number | Required | available occurrences in scan recorded for this result. |
| `coverage.scanned_occurrence_count` | number | Required | scanned occurrence count recorded for this result. |
| `coverage.included_occurrence_count` | number | Required | included occurrence count recorded for this result. |
| `coverage.invalid_occurrence_count` | number | Required | invalid occurrence count recorded for this result. |
| `coverage.occurrence_payload_bytes` | number | Required | occurrence payload bytes recorded for this result. |
| `coverage.watch_payload_bytes` | number | Required | watch payload bytes recorded for this result. |
| `coverage.watch_scan_limit` | number | Required | watch scan limit recorded for this result. |
| `coverage.occurrence_scan_limit` | number | Required | occurrence scan limit recorded for this result. |
| `coverage.watch_payload_byte_limit` | number | Required | watch payload byte limit recorded for this result. |
| `coverage.occurrence_payload_byte_limit` | number | Required | occurrence payload byte limit recorded for this result. |
| `coverage.included_observation_oldest_at` | string / null | Required | included observation oldest at recorded for this result. |
| `coverage.included_observation_newest_at` | string / null | Required | included observation newest at recorded for this result. |
| `coverage.partial` | boolean | Required | partial recorded for this result. |
| `coverage.limitations` | array | Required | limitations recorded for this result. |
| `analysis_partial` | boolean | Required | analysis partial recorded for this result. |
| `freshness` | object | Required | freshness recorded for this result. |
| `freshness.oldest_last_success_at` | string / null | Required | oldest last success at recorded for this result. |
| `freshness.newest_last_success_at` | string / null | Required | newest last success at recorded for this result. |
| `freshness.oldest_latest_attempt_at` | string / null | Required | oldest latest attempt at recorded for this result. |
| `freshness.newest_latest_attempt_at` | string / null | Required | newest latest attempt at recorded for this result. |
| `counting_notes` | array | Required | counting notes recorded for this result. |
| `counts` | object | Required | counts recorded for this result. |
| `counts.watches` | number | Required | watches recorded for this result. |
| `counts.status` | object | Required | Resource lifecycle status. |
| `counts.status.active` | number | Required | active recorded for this result. |
| `counts.status.paused` | number | Required | paused recorded for this result. |
| `counts.never_checked` | number | Required | never checked recorded for this result. |
| `counts.current_state` | object | Required | current state recorded for this result. |
| `counts.current_state.present` | number | Required | present recorded for this result. |
| `counts.current_state.suspected_missing` | number | Required | suspected missing recorded for this result. |
| `counts.current_state.confirmed_missing` | number | Required | confirmed missing recorded for this result. |
| `counts.current_state.source_unavailable` | number | Required | source unavailable recorded for this result. |
| `counts.current_state.unknown` | number | Required | unknown recorded for this result. |
| `counts.latest_attempt` | object | Required | latest attempt recorded for this result. |
| `counts.latest_attempt.present` | number | Required | present recorded for this result. |
| `counts.latest_attempt.absent` | number | Required | absent recorded for this result. |
| `counts.latest_attempt.source_unavailable` | number | Required | source unavailable recorded for this result. |
| `counts.latest_attempt.unknown` | number | Required | unknown recorded for this result. |
| `counts.latest_attempt.evidence_unavailable` | number | Required | evidence unavailable recorded for this result. |
| `counts.last_successful_observation` | object | Required | last successful observation recorded for this result. |
| `counts.last_successful_observation.present` | number | Required | present recorded for this result. |
| `counts.last_successful_observation.absent` | number | Required | absent recorded for this result. |
| `counts.last_successful_observation.source_unavailable` | number | Required | source unavailable recorded for this result. |
| `counts.last_successful_observation.none` | number | Required | none recorded for this result. |
| `counts.last_successful_observation.evidence_unavailable` | number | Required | evidence unavailable recorded for this result. |
| `counts.complete_present_evidence_in_scan` | number | Required | complete present evidence in scan recorded for this result. |
| `counts.known_present_after_unknown` | number | Required | known present after unknown recorded for this result. |
| `monitored_source_hosts` | object | Required | monitored source hosts recorded for this result. |
| `monitored_source_hosts.items` | array | Required | Records in this bounded page. |
| `monitored_source_hosts.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `monitored_source_hosts.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `monitored_source_hosts.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `monitored_source_hosts.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `monitored_source_hosts.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `monitored_source_hosts.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `monitored_source_hosts.items[].hostname` | string | Optional | hostname recorded for this result. |
| `monitored_source_hosts.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `monitored_source_hosts.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `monitored_source_hosts.items[].anchor` | string | Optional | anchor recorded for this result. |
| `monitored_source_hosts.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `monitored_source_hosts.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `monitored_source_hosts.items[].term` | string | Optional | term recorded for this result. |
| `monitored_source_hosts.items[].tokens` | array | Optional | tokens recorded for this result. |
| `monitored_source_hosts.total_groups` | number | Required | total groups recorded for this result. |
| `monitored_source_hosts.returned_groups` | number | Required | returned groups recorded for this result. |
| `monitored_source_hosts.truncated` | boolean | Required | truncated recorded for this result. |
| `monitored_targets` | object | Required | monitored targets recorded for this result. |
| `monitored_targets.items` | array | Required | Records in this bounded page. |
| `monitored_targets.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `monitored_targets.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `monitored_targets.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `monitored_targets.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `monitored_targets.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `monitored_targets.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `monitored_targets.items[].hostname` | string | Optional | hostname recorded for this result. |
| `monitored_targets.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `monitored_targets.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `monitored_targets.items[].anchor` | string | Optional | anchor recorded for this result. |
| `monitored_targets.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `monitored_targets.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `monitored_targets.items[].term` | string | Optional | term recorded for this result. |
| `monitored_targets.items[].tokens` | array | Optional | tokens recorded for this result. |
| `monitored_targets.total_groups` | number | Required | total groups recorded for this result. |
| `monitored_targets.returned_groups` | number | Required | returned groups recorded for this result. |
| `monitored_targets.truncated` | boolean | Required | truncated recorded for this result. |
| `observed_referring_hosts` | object | Required | observed referring hosts recorded for this result. |
| `observed_referring_hosts.items` | array | Required | Records in this bounded page. |
| `observed_referring_hosts.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `observed_referring_hosts.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `observed_referring_hosts.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `observed_referring_hosts.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `observed_referring_hosts.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `observed_referring_hosts.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `observed_referring_hosts.items[].hostname` | string | Optional | hostname recorded for this result. |
| `observed_referring_hosts.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `observed_referring_hosts.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `observed_referring_hosts.items[].anchor` | string | Optional | anchor recorded for this result. |
| `observed_referring_hosts.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `observed_referring_hosts.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `observed_referring_hosts.items[].term` | string | Optional | term recorded for this result. |
| `observed_referring_hosts.items[].tokens` | array | Optional | tokens recorded for this result. |
| `observed_referring_hosts.total_groups` | number | Required | total groups recorded for this result. |
| `observed_referring_hosts.returned_groups` | number | Required | returned groups recorded for this result. |
| `observed_referring_hosts.truncated` | boolean | Required | truncated recorded for this result. |
| `observed_targets` | object | Required | observed targets recorded for this result. |
| `observed_targets.items` | array | Required | Records in this bounded page. |
| `observed_targets.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `observed_targets.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `observed_targets.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `observed_targets.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `observed_targets.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `observed_targets.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `observed_targets.items[].hostname` | string | Optional | hostname recorded for this result. |
| `observed_targets.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `observed_targets.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `observed_targets.items[].anchor` | string | Optional | anchor recorded for this result. |
| `observed_targets.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `observed_targets.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `observed_targets.items[].term` | string | Optional | term recorded for this result. |
| `observed_targets.items[].tokens` | array | Optional | tokens recorded for this result. |
| `observed_targets.total_groups` | number | Required | total groups recorded for this result. |
| `observed_targets.returned_groups` | number | Required | returned groups recorded for this result. |
| `observed_targets.truncated` | boolean | Required | truncated recorded for this result. |
| `link_rel_sets` | object | Required | link rel sets recorded for this result. |
| `link_rel_sets.items` | array | Required | Records in this bounded page. |
| `link_rel_sets.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `link_rel_sets.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `link_rel_sets.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `link_rel_sets.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `link_rel_sets.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `link_rel_sets.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `link_rel_sets.items[].hostname` | string | Optional | hostname recorded for this result. |
| `link_rel_sets.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `link_rel_sets.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `link_rel_sets.items[].anchor` | string | Optional | anchor recorded for this result. |
| `link_rel_sets.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `link_rel_sets.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `link_rel_sets.items[].term` | string | Optional | term recorded for this result. |
| `link_rel_sets.items[].tokens` | array | Optional | tokens recorded for this result. |
| `link_rel_sets.total_groups` | number | Required | total groups recorded for this result. |
| `link_rel_sets.returned_groups` | number | Required | returned groups recorded for this result. |
| `link_rel_sets.truncated` | boolean | Required | truncated recorded for this result. |
| `link_rel_tokens` | object | Required | link rel tokens recorded for this result. |
| `link_rel_tokens.items` | array | Required | Records in this bounded page. |
| `link_rel_tokens.items[].distinct_watch_count` | number | Required | distinct watch count recorded for this result. |
| `link_rel_tokens.items[].example_watch_ids` | array | Required | example watch ids recorded for this result. |
| `link_rel_tokens.items[].occurrence_count` | number | Optional | occurrence count recorded for this result. |
| `link_rel_tokens.items[].watch_count` | number | Optional | watch count recorded for this result. |
| `link_rel_tokens.items[].token_occurrence_count` | number | Optional | token occurrence count recorded for this result. |
| `link_rel_tokens.items[].link_occurrence_count` | number | Optional | link occurrence count recorded for this result. |
| `link_rel_tokens.items[].hostname` | string | Optional | hostname recorded for this result. |
| `link_rel_tokens.items[].target_url` | string | Optional | Destination URL recorded in this evidence. |
| `link_rel_tokens.items[].target_scope` | string | Optional | target scope recorded for this result. |
| `link_rel_tokens.items[].anchor` | string | Optional | anchor recorded for this result. |
| `link_rel_tokens.items[].empty_anchor` | boolean | Optional | empty anchor recorded for this result. |
| `link_rel_tokens.items[].token` | string | Optional | Invitation token returned only at creation. The accepting account must have the matching verified email. |
| `link_rel_tokens.items[].term` | string | Optional | term recorded for this result. |
| `link_rel_tokens.items[].tokens` | array | Optional | tokens recorded for this result. |
| `link_rel_tokens.total_groups` | number | Required | total groups recorded for this result. |
| `link_rel_tokens.returned_groups` | number | Required | returned groups recorded for this result. |
| `link_rel_tokens.truncated` | boolean | Required | truncated recorded for this result. |
| `rel_facts` | object | Required | rel facts recorded for this result. |
| `rel_facts.included_occurrences` | number | Required | included occurrences recorded for this result. |
| `rel_facts.no_link_nofollow_token_occurrences` | number | Required | no link nofollow token occurrences recorded for this result. |
| `rel_facts.page_nofollow_occurrences` | number | Required | page nofollow occurrences recorded for this result. |
| `rel_facts.ranking_credit_inferred` | boolean | Required | ranking credit inferred recorded for this result. must equal false |
[Download input schema](/schemas/get_link_profile.input.json) · [Download output schema](/schemas/get_link_profile.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
These existing resource routes share the operation’s domain behavior. Their parameter placement, status and response envelope can differ from generic invocation. See [HTTP route details](/reference/http/routes).
| Method and route | Success | Details |
| ------------------------- | ------- | ------------------------------------------------ |
| `GET /v1/reports/profile` | 200 | Remaining read arguments go in query parameters. |
## Continue
[export\_link\_watches](/reference/commands/export_link_watches)
Follow the [related workflow](/guides/sync-and-export), inspect [capability status](/capability-status), or return to the [command index](/reference/index).