---
title: "Get link profile"
method: POST
path: "/v1/commands/get_link_profile"
tags: ["Reports and exports"]
---

# Get link profile

`POST /v1/commands/get_link_profile`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/get_link_profile`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

## Headers

- `X-Workspace-ID` string

## Request body

- GetLinkProfileInput
  - `projectId` string: project ID from create/list.
  - `status` 'all' | 'active' | 'paused': Lifecycle status, separate from observed state.
  - `limit` integer: Page/report row cap; see bounds.

## Response `200`

Command result, including queued admission.

- GetLinkProfileOutput
  - `schema_version` number, required
  - `workspace_id` string, required: Workspace that owns this record.
  - `project_id` string, nullable, required: Project that owns this record.
  - `status_filter` string, required
  - `generated_at` string, required
  - `coverage` object, required: Dataset scope and completeness, including limits on what these results establish.
    - `denominator` string, required
    - `whole_web_coverage` false, required: False: these results do not measure the whole web.
    - `observation_basis` string, required
    - `includes_paused` boolean, required
    - `project_grant` string, required
    - `watch_count` number, required
    - `scanned_watch_count` number, required
    - `eligible_present_watches_in_scan` number, required
    - `excluded_evidence_watches_in_scan` number, required
    - `available_occurrences_in_scan` number, required
    - `scanned_occurrence_count` number, required
    - `included_occurrence_count` number, required
    - `invalid_occurrence_count` number, required
    - `occurrence_payload_bytes` number, required
    - `watch_payload_bytes` number, required
    - `watch_scan_limit` number, required
    - `occurrence_scan_limit` number, required
    - `watch_payload_byte_limit` number, required
    - `occurrence_payload_byte_limit` number, required
    - `included_observation_oldest_at` string, nullable, required
    - `included_observation_newest_at` string, nullable, required
    - `partial` boolean, required
    - `limitations` string[], required
  - `analysis_partial` boolean, required
  - `freshness` object, required
    - `oldest_last_success_at` string, nullable, required
    - `newest_last_success_at` string, nullable, required
    - `oldest_latest_attempt_at` string, nullable, required
    - `newest_latest_attempt_at` string, nullable, required
  - `counting_notes` string[], required
  - `counts` object, required
    - `watches` number, required
    - `status` object, required: Resource lifecycle status.
      - `active` number, required
      - `paused` number, required
    - `never_checked` number, required
    - `current_state` object, required
      - `present` number, required
      - `suspected_missing` number, required
      - `confirmed_missing` number, required
      - `source_unavailable` number, required
      - `unknown` number, required
      - `prospect` number
      - `unverified` number
    - `latest_attempt` object, required
      - `present` number, required
      - `absent` number, required
      - `source_unavailable` number, required
      - `unknown` number, required
      - `evidence_unavailable` number, required
    - `last_successful_observation` object, required
      - `present` number, required
      - `absent` number, required
      - `source_unavailable` number, required
      - `none` number, required
      - `evidence_unavailable` number, required
    - `complete_present_evidence_in_scan` number, required
    - `known_present_after_unknown` number, required
  - `monitored_source_hosts` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `monitored_targets` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `observed_referring_hosts` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `observed_targets` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `link_rel_sets` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `link_rel_tokens` object, required
    - `items` object[], required: Records in this bounded page.
      - `distinct_watch_count` number, required
      - `example_watch_ids` string[], required
      - `occurrence_count` number
      - `watch_count` number
      - `token_occurrence_count` number
      - `link_occurrence_count` number
      - `hostname` string
      - `target_url` string: Destination URL recorded in this evidence.
      - `target_scope` string
      - `anchor` string
      - `empty_anchor` boolean
      - `token` string: Invitation token returned only at creation. The accepting account must have the matching verified email.
      - `term` string
      - `tokens` string[]
    - `total_groups` number, required
    - `returned_groups` number, required
    - `truncated` boolean, required
  - `rel_facts` object, required
    - `included_occurrences` number, required
    - `no_link_nofollow_token_occurrences` number, required
    - `page_nofollow_occurrences` number, required
    - `ranking_credit_inferred` false, required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

## Changes

- **2026-10-20** `1bf30c2912b2`: 2 info
  - added the optional property `counts/current_state/prospect` to the response with the `200` status
  - added the optional property `counts/current_state/unverified` to the response with the `200` status

[Operation history](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/changes/v1/commands/get_link_profile/post.md)

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/1bf30c2912b2?raw)