---
title: "Get a content item's citation prompts"
method: GET
path: "/org/content/{id}/citation-prompts"
tags: ["Content"]
---

# Get a content item's citation prompts

`GET /org/content/{id}/citation-prompts`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/content/{id}/citation-prompts`
- Auth: API key in header `X-API-Key`

Returns the prompt/model rows whose question runs cite at least one of a published content item's live external URLs, with mention-rate and average-SOV lift versus runs that cite none of those URLs. Requires the GEO product.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `start_date` string, date
- `end_date` string, date
- `models` string
- `locations` string
- `destinations` string

## Response `200`

The content item's citation prompts.

- ContentCitationPromptsResponse: The prompt/model rows whose runs cite a content item's live external URLs.
  - `content_id` string, uuid, required
  - `date_range` ContentCitationDateRange, required: The requested date window, echoed back (null bounds mean unbounded).
    - `start_date` string, nullable, required: Inclusive start date (YYYY-MM-DD), or null.
    - `end_date` string, nullable, required: Inclusive end date (YYYY-MM-DD), or null.
  - `models` string[], required
  - `external_urls` string[], required: The content's live external URLs the citations were matched against.
  - `prompts` ContentCitationPromptRow[], required
    - `prompt` string, required
    - `prompt_funnel_stage` string, required: The prompt's funnel stage (e.g. `awareness`, `consideration`, `evaluation`, `decision`).
    - `model` string, required
    - `source_id` string, required
    - `mention_rate` number, required: Of this prompt/model's non-empty answers in the window, the share that named your brand — a **0–1 fraction**, unlike `citation_rate` on the same row. `0` when there were no answered runs.
    - `avg_sov` number, required: Your share of every brand mention on this prompt/model — mention instances for you over mention instances for all brands. A **0–1 fraction**, unlike `citation_rate` on the same row. `0` when no brand mentions were recorded.
    - `common_sentiment` string, required: The most common sentiment across this prompt/model's mentions of your brand — `positive`, `neutral`, or `negative`. Ties break toward `positive`, then `negative`; `neutral` when your brand was never mentioned.
    - `eval_count` integer, required: Non-empty answers for this prompt/model in the window. The denominator of `mention_rate` and of `citation_rate`.
    - `citation_count` integer, required: Answers on this prompt/model that cited one of the content's live external URLs. The numerator of `citation_rate`.
    - `citation_rate` number: `citation_count / eval_count * 100` — of this prompt/model's answered runs, the share that cited one of the content's live external URLs, as a percentage on a **0–100** scale (not a 0–1 fraction). The denominator is every answered run, not only the answers that carried a citation, so this is a share of all answers rather than the Citation Coverage of `GET /org/analytics/*`. Both operands ship on the row. Absent when `eval_count` was zero.
    - `mention_rate_lift` number, nullable, required: Mention-rate lift versus baseline; null when there is no baseline.
    - `avg_sov_lift` number, nullable, required: Average-SOV lift versus baseline; null when there is no baseline.

## Other responses

- `400`: The request was malformed — a bad path/query parameter or an invalid value.
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `403`: The API key is authenticated but not permitted to access this resource.
- `404`: The requested resource does not exist or is not visible to this key.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)