---
title: "Shared opportunities"
method: GET
path: "/api/share/{token}/sites/{id}/opportunities"
tags: ["Share"]
---

# Shared opportunities

`GET /api/share/{token}/sites/{id}/opportunities`

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/share/{token}/sites/{id}/opportunities`
- Auth: none declared

Lists saved opportunity recommendations through a read-only share token. Returns only validated customer-visible outputs with cited evidence.

## Path parameters

- `token` string, required
- `id` string, uuid, required

## Response `200`

Opportunity list

- SharedOpportunityListResponse
  - `opportunities` SharedOpportunity[], required
    - `action_key` string, required
    - `cited_evidence_ids` string[], required
    - `confidence` 'high' | 'medium', required
    - `copy_params` object, required
    - `created_at` string, date-time, required
    - `detector_version` string, required
    - `digest_key` string, required
    - `evidence` OpportunityEvidence[], required
      - `detail_key` string
      - `detail_params` object
      - `id` string, required
      - `label_key` string, required
      - `value` string, required
    - `generated_at` string, date-time, required
    - `id` string, uuid, required
    - `impact_label_key` string, required
    - `impact_value` string, required
    - `kind` 'conversion' | 'traffic' | 'ai' | 'search' | 'setup', required
    - `route_icon` string, required
    - `route_label_key` string, required
    - `route_params` object
    - `score` integer, required
    - `score_breakdown` OpportunityScoreBreakdown, required
      - `actionability` integer, required
      - `effort` integer, required
      - `evidence_fit` integer, required
      - `freshness` integer, required
      - `impact` integer, required
      - `sample` integer, required
      - `total` integer, required
      - `urgency` integer, required
    - `site_id` string, uuid, required
    - `status` 'new' | 'saved' | 'done' | 'dismissed', required
    - `summary_key` string, required
    - `title_key` string, required
    - `type_key` string, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)
