---
title: "GET /v1/projects/{project_id}/visibility/trends"
method: GET
path: "/v1/projects/{project_id}/visibility/trends"
tags: ["visibility"]
---

# GET /v1/projects/{project_id}/visibility/trends

`GET /v1/projects/{project_id}/visibility/trends`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/visibility/trends`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `market` string, uuid, nullable
- `engine` string, nullable
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `granularity` string
- `transport_model` string, nullable
- `retrieval_enabled` boolean, nullable
- `cohort` 'core' | 'comparison' | 'all'

## Response `200`

Successful Response

- VisibilityTrendPoint[]
  - `audit_id` string, uuid, nullable, required
  - `completed_at` string, required
  - `logical_engine` string, nullable, required
  - `visibility_score` number, nullable, required
  - `visibility_rate` number, nullable
  - `prompt_performance_score` number, nullable
  - `counts` MeasurementCounts
    - `state` string, required
    - `responses` integer, required
    - `brand_responses` integer, nullable, required
    - `owned_citation_responses` integer, nullable, required
    - `entity_presences` integer, nullable, required
    - `expected` integer, nullable, required
    - `failed` integer, nullable, required
    - `not_run` integer, nullable, required
  - `comparison_key` string, nullable
  - `run_count` integer
  - `source_audit_ids` string[]
  - `brand_mention_rate` number, nullable, required
  - `owned_citation_rate` number, nullable, required
  - `sov` object, required
    - `mention` number, nullable, required
  - `rankings` RankingRow[], required
    - `name` string, required
    - `is_brand` boolean, required
    - `logo_url` string, nullable
    - `website_url` string, nullable
    - `mention_rate` number, nullable, required
    - `citation_rate` number, nullable, required
    - `share_of_voice` number, nullable, required
    - `mention_count` integer, required
    - `visibility_delta` number, nullable
    - `gap_count` integer, nullable
    - `matched_visibility_rate` number, nullable
    - `matched_visibility_delta` number, nullable
    - `matched_response_count` integer, nullable
    - `avg_position` number, nullable, required
  - `avg_position` number, nullable, required
  - `transport_model` string, nullable, required
  - `retrieval_enabled` boolean, nullable, required
  - `model_provenance` ModelProvenance[], required
    - `logical_engine` string, required
    - `transport_provider` string, required
    - `transport_model` string, required
    - `retrieval_enabled` boolean, nullable, required
  - `source_snapshot_ids` string[], required
  - `analyzer_versions` string[], required
  - `scoring_rule_versions` string[], required
  - `spans_version_boundary` boolean, required

---

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