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

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

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

## Request

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

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `audit_id` string, uuid, nullable
- `audit_ids` string[], nullable
- `market` string, uuid, nullable
- `engine` string, nullable
- `cohort` 'core' | 'comparison' | 'all'
- `from` string, date-time, nullable
- `to` string, date-time, nullable

## Response `200`

Successful Response

- PerceptionResponse
  - `state` 'value' | 'pending' | 'unavailable' | 'no_mentions', required
  - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', nullable, required
  - `source_audit_ids` string[], required
  - `brand` PerceptionEntity, required
    - `name` string, required
    - `is_brand` boolean, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `coverage` PerceptionCoverage, required
      - `mentions` integer, required
      - `classified` integer, required
      - `pending` integer, required
      - `not_assessable` integer, required
      - `low_confidence` integer, required
      - `unavailable` object[], required
        - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
        - `count` integer, required
  - `coverage` PerceptionCoverage, required
    - `mentions` integer, required
    - `classified` integer, required
    - `pending` integer, required
    - `not_assessable` integer, required
    - `low_confidence` integer, required
    - `unavailable` object[], required
      - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
      - `count` integer, required
  - `entities` PerceptionEntity[], required
    - `name` string, required
    - `is_brand` boolean, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `coverage` PerceptionCoverage, required
      - `mentions` integer, required
      - `classified` integer, required
      - `pending` integer, required
      - `not_assessable` integer, required
      - `low_confidence` integer, required
      - `unavailable` object[], required
        - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
        - `count` integer, required
  - `engines` PerceptionBreakdown[], required
    - `key` string, required
    - `label` string, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `coverage` PerceptionCoverage, required
      - `mentions` integer, required
      - `classified` integer, required
      - `pending` integer, required
      - `not_assessable` integer, required
      - `low_confidence` integer, required
      - `unavailable` object[], required
        - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
        - `count` integer, required
  - `topics` PerceptionBreakdown[], required
    - `key` string, required
    - `label` string, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `coverage` PerceptionCoverage, required
      - `mentions` integer, required
      - `classified` integer, required
      - `pending` integer, required
      - `not_assessable` integer, required
      - `low_confidence` integer, required
      - `unavailable` object[], required
        - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
        - `count` integer, required
  - `prompts` PerceptionBreakdown[], required
    - `key` string, required
    - `label` string, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `coverage` PerceptionCoverage, required
      - `mentions` integer, required
      - `classified` integer, required
      - `pending` integer, required
      - `not_assessable` integer, required
      - `low_confidence` integer, required
      - `unavailable` object[], required
        - `reason` 'model_not_configured' | 'platform_cap' | 'entity_limit' | 'invalid_output' | 'model_error' | 'task_failed' | 'not_assessable', required
        - `count` integer, required
  - `themes` object[], required
    - `theme` string, required
    - `positive` integer, required
    - `negative` integer, required
    - `quotes` PerceptionQuote[], required
      - `text` string, required
      - `theme` string, required
      - `polarity` 'positive' | 'negative', required
      - `entity` string, required
      - `is_brand` boolean, required
      - `logical_engine` string, required
      - `prompt` string, required
      - `run_id` string, uuid, required
      - `execution_id` string, uuid, required
      - `observed_at` string, required
      - `extractor_version` string, required
      - `template_version` string, required
  - `negative_quotes` PerceptionQuote[], required
    - `text` string, required
    - `theme` string, required
    - `polarity` 'positive' | 'negative', required
    - `entity` string, required
    - `is_brand` boolean, required
    - `logical_engine` string, required
    - `prompt` string, required
    - `run_id` string, uuid, required
    - `execution_id` string, uuid, required
    - `observed_at` string, required
    - `extractor_version` string, required
    - `template_version` string, required
  - `drivers` object[], required
    - `domain` string, required
    - `answers` integer, required
    - `example_url` string, nullable, required
  - `recommended` object, required
    - `mentioned` integer, required
    - `recommended` integer, required
    - `recommended_against` integer, required
    - `rate` number, nullable, required
    - `limitation` string, required
  - `trend` object[], required
    - `audit_id` string, uuid, required
    - `completed_at` string, required
    - `score` PerceptionScore, required
      - `positive` integer, required
      - `neutral` integer, required
      - `negative` integer, required
      - `mixed` integer, required
      - `classified` integer, required
      - `positive_share` number, nullable, required
      - `negative_share` number, nullable, required
      - `net_sentiment` number, nullable, required
    - `mentions` integer, required
    - `extractor_version` string, required
    - `template_version` string, required
    - `metrics_version` string, required
    - `comparable` 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)