---
title: "List the answers citing an owned-media item"
method: GET
path: "/dimensions/owned_media/citing_prompts"
tags: ["Owned Media & Communities"]
---

# List the answers citing an owned-media item

`GET /dimensions/owned_media/citing_prompts`

## Request

- Base URL: `https://api.llmpulse.ai/api/v1`
- URL: `https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts`
- Auth: API key in header `Authorization`

The drill-down behind one row of an Owned Media or YouTube Intelligence table. Pass exactly one of url (a post or video URL, any variant of it) or profile (a handle with or without @, a profile or channel URL, or the channel key the YouTube channels rows return). item describes it (title, image, owner, whether it is yours and its stats), citation_count and prompt_count count its citations in the window, and data lists the citing answers newest first, each with its prompt, answer id, model, country, language, execution date, a plain-text excerpt and its link in the app. It shows prompt and answer text, so a team member also needs the Prompts permission, and YouTube Intelligence for provider=youtube. Defaults to the last 30 days. Requires the Growth plan or above.

## Query parameters

- `project_id` integer, required
- `page` integer
- `per_page` integer
- `provider` 'youtube' | 'instagram' | 'facebook' | 'tiktok' | 'linkedin', required
- `url` string
- `profile` string
- `model` 'chatgpt' | 'perplexity' | 'ai_mode' | 'ai_overview' | 'gemini' | 'copilot' | 'amazon_rufus' | 'claude' | 'grok' | 'deepseek' | 'naver_ai' | 'baidu_ai' | 'meta_ai' | 'naver_ai_tab' | 'qwen' | 'doubao'
- `collection_id` string
- `country_code` string
- `language_code` string
- `brand_kind` 'brand' | 'brand_other' | 'non_brand'
- `range` integer
- `from` string, date-time
- `to` string, date-time
- `output` 'flat' | 'csv'

## Response `200`

The item and a page of the answers that cited it

- OwnedMediaCitingPromptsResponse
  - `project_id` integer
  - `provider` string
  - `from` string, date-time
  - `to` string, date-time
  - `item` OwnedMediaCitedItem, nullable: The post, video, profile or channel. Null when nothing in the window matches it
    - `kind` 'post' | 'profile': post covers posts and videos, profile covers profiles and channels
    - `title` string, nullable
    - `subtitle` string, nullable
    - `url` string, nullable
    - `image_url` string, nullable
    - `yours` boolean
    - `date` string, date-time, nullable: Publication date of a post or video
    - `stats` object: The counts the platform reports for the item; absent keys are unknown
      - `citations` integer
      - `likes` integer
      - `comments` integer
      - `views` integer
      - `followers` integer
      - `unique_posts` integer
      - `unique_videos` integer
  - `citation_count` integer: Citations of the item in the window
  - `prompt_count` integer: Distinct prompts whose answers cited it
  - `page` integer
  - `per_page` integer
  - `total` integer: Citing answers
  - `data` OwnedMediaCitingAnswer[]
    - `answer_id` integer: The answer (prompt execution) id, readable with GET /answers/{id}
    - `prompt_id` integer
    - `prompt_text` string
    - `model` string
    - `country_code` string, nullable
    - `language_code` string, nullable
    - `executed_at` string, date-time, nullable
    - `excerpt` string, nullable: The start of the answer as plain text (at most 300 characters)
    - `app_url` string: The answer in the app
  - `request_id` string

## Other responses

- `403`: A plan below Growth answers ERR_PLAN_REQUIRED. A team member whose permissions do not grant Owned Media and Prompts (and YouTube Intelligence for provider=youtube) answers ERR_INSUFFICIENT_PERMISSION, with the same status
- `404`: Resource not found
- `422`: Invalid parameters

## Changes

- **2026-10-16** `dd090b1e1154`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/llmpulse/apis/llm-pulse-api/changes/dimensions/owned_media/citing_prompts/get.md)

---

[API](https://skmtc.dev/llmpulse/apis/llm-pulse-api.md) - [All operations](https://skmtc.dev/llmpulse/apis/llm-pulse-api/llms.txt) - [OpenAPI document](https://skmtc.dev/llmpulse/apis/llm-pulse-api/revisions/38a31f123641?raw)
