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

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

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

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/visibility/sources`
- 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
- `baseline_audit_ids` string[], nullable
- `engine` string, nullable
- `cohort` 'core' | 'comparison' | 'all'
- `domain` string, nullable
- `source_type` string, nullable
- `standing` 'gap', nullable
- `dimension` 'domain' | 'url'
- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `as_of` string, date-time, nullable
- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- VisibilitySources
  - `previous_cursor` string, nullable
  - `total` integer, required
  - `responses` integer, required
  - `prompts` integer, required
  - `total_citations` integer, required
  - `category_totals` object
  - `next_cursor` string, nullable, required
  - `as_of` string, required
  - `comparison_status` string, required
  - `retrieval` object, required
    - `responses` integer, required
    - `unavailable_engines` string[], required
  - `items` object[], required
    - `key` string, required
    - `retrieved` integer, nullable, required
    - `responses` integer, required
    - `prompts` integer, required
    - `annotations` integer, required
    - `urls` integer, required
    - `response_rate` number, nullable, required
    - `prompt_coverage` number, nullable, required
    - `retrieval_rate` number, nullable, required
    - `citation_share` number, nullable, required
    - `citation_rate` number, nullable, required
    - `ownership` string[], required
    - `categories` string[], required
    - `taxonomy_versions` string[], required
    - `category_unavailable` boolean, required
    - `response_delta` number, nullable, required
    - `url_hash` string, nullable, required
    - `inspection_state` string, nullable, required
    - `opportunity_id` string, uuid, nullable, required
    - `standing` 'yours' | 'competitor' | 'blocked' | 'unreadable' | 'not_read' | 'gap' | 'listed' | 'read', required
    - `action_id` string, uuid, nullable, required
    - `title` string, nullable, required
    - `page_format` string, nullable, required
    - `page_format_method` string, nullable, required
    - `last_cited_at` string, nullable, required
    - `mentions` integer, required
    - `brands` object[], required
      - `kind` 'brand' | 'competitor', required
      - `name` string, required
      - `responses` integer, required
      - `logo_url` string, nullable, required
      - `website` string, nullable, 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)
