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

# Get a content item's citation details

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

## Request

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

Returns citation detail for a published content item — a pooled summary, per-destination metrics, and a daily trend — over an optional date window and model/location filter. Requires the GEO product.

## Path parameters

- `id` string, uuid, required

## Query parameters

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

## Response `200`

The content item's citation details.

- ContentCitationDetailsResponse: A content item's citation detail — pooled summary, per-destination metrics, and a daily trend.
  - `content_id` string, uuid, required
  - `title` string, 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: The AI models the results are filtered to (empty means all).
  - `earliest_publish_at` string, date-time, nullable, required
  - `first_citation_at` string, date-time, nullable, required
  - `days_to_first_citation` integer, nullable, required
  - `summary` ContentCitationSummary, required: Pooled citation metrics across all of a content item's destinations.
    - `total_citations` integer, required: Citation **instances** across every destination of this content item in the window — an answer citing it three times contributes three.
    - `avg_sov` number, required: Your share of every brand mention, restricted to the answers that cited this content — a **0–1 fraction**. `0` when no brand mentions were recorded.
    - `mention_rate` number, required: Of the answers that **cited this content**, the share that named your brand — a **0–1 fraction**. Note the denominator: this is a conditional mention rate over citing answers, not the org-wide `mention_rate` of `GET /org/analytics/*`, which divides by all answered runs.
    - `common_sentiment` string, required: The most common sentiment across citing runs (e.g. `positive`, `neutral`, `negative`).
    - `prompt_run_count` integer, required: Prompt-run answers in the window **across the whole organization**, not just those citing this content. It is the shared base behind the summary and trend blocks, not the denominator of the ratios above.
  - `destinations` ContentCitationDestination[], required
    - `publish_record_id` string, uuid, required
    - `publisher_name` string, required
    - `publisher_slug` string, required
    - `state` string, required
    - `external_url` string, required
    - `first_published_at` string, date-time, nullable, required
    - `first_citation_at` string, date-time, nullable, required
    - `days_to_first_citation` integer, nullable, required
    - `metrics` ContentCitationMetrics, required: Citation metrics for one destination.
      - `total_citations` integer, required: Citation **instances** for this destination in the window.
      - `avg_sov` number, required: Your share of every brand mention, restricted to the answers that cited this destination's URL — a **0–1 fraction**.
      - `mention_rate` number, required: Of the answers that cited this destination's URL, the share that named your brand — a **0–1 fraction**. A conditional mention rate over citing answers, not the org-wide one.
      - `common_sentiment` string, required: The most common sentiment across those citing answers' mentions of your brand.
  - `trend` ContentCitationTrendPoint[], required
    - `date` string, required: The day (YYYY-MM-DD).
    - `total_citations` integer, required
    - `total_prompt_runs` integer, required
    - `by_destination` object, required: Per-destination counts for the day, keyed by publish record id.

## 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)