Get link profile

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, CLI, or HTTP. Replace example identifiers with records from your workspace.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_link_profile",
    "arguments": {}
  }
}

linktrail call get_link_profile --args '{}'

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.

{
  "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 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 · Download output schema

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

Method and route	Success	Details
`GET /v1/reports/profile`	200	Remaining read arguments go in query parameters.

Continue

export_link_watches Follow the related workflow, inspect capability status, or return to the command index.

Overview

Cloud operations

Repository tools

HTTP and events

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue