---
title: "Get an owned-media summary"
method: GET
path: "/dimensions/owned_media/summary"
tags: ["Owned Media & Communities"]
---

# Get an owned-media summary

`GET /dimensions/owned_media/summary`

## Request

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

The numbers behind one Owned Media tab. kpis gives the platform citations (total), yours (your profiles and their content), your_profile and your_content apart, and share_pct; previous gives the same KPIs for the period of the same length that ends just before from, and changes the difference (percent for counts, percentage points for share_pct, null when there is nothing to compare). weekly is the citations per week, yours against everyone else. by_model and by_country split every citation of the platform; content_types (reel, post, tv, pulse, or regular, shorts and live on YouTube) and age_buckets cover posts and videos. provider=mobile_apps adds stores, the per-store totals, and has no content type or age; provider=overview returns platforms, one rollup per platform the caller can read, and no breakdowns. A team member also needs the YouTube Intelligence permission for provider=youtube. Defaults to the last 30 days. Requires the Growth plan or above.

## Query parameters

- `project_id` integer, required
- `provider` 'youtube' | 'instagram' | 'facebook' | 'tiktok' | 'linkedin' | 'mobile_apps' | 'overview', required
- `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

## Response `200`

The KPI cards, comparison, weekly series and breakdowns

- OwnedMediaSummaryResponse
  - `project_id` integer
  - `provider` string
  - `from` string, date-time
  - `to` string, date-time
  - `connected` boolean: Whether a profile is claimed on the platform (on overview, on any platform)
  - `kpis` OwnedMediaKpis
    - `total` integer: Citations of the platform in the window, yours and everyone else's
    - `yours` integer: Citations of your own profiles and their content
    - `your_profile` integer, nullable: Citations of your profile or channel pages. Null for mobile_apps and overview
    - `your_content` integer, nullable: Citations of your posts or videos. Null for mobile_apps and overview
    - `share_pct` number: yours as a percentage of total (0-100)
  - `previous` object: The period of the same length that ends just before from
    - `from` string, date-time
    - `to` string, date-time
    - `kpis` OwnedMediaKpis
      - `total` integer: Citations of the platform in the window, yours and everyone else's
      - `yours` integer: Citations of your own profiles and their content
      - `your_profile` integer, nullable: Citations of your profile or channel pages. Null for mobile_apps and overview
      - `your_content` integer, nullable: Citations of your posts or videos. Null for mobile_apps and overview
      - `share_pct` number: yours as a percentage of total (0-100)
  - `changes` OwnedMediaKpiChanges: Change against the previous period. Counts in percent, share_pct in percentage points; null when the previous period has nothing to compare with
    - `total` number, nullable
    - `yours` number, nullable
    - `your_profile` number, nullable
    - `your_content` number, nullable
    - `share_pct` number, nullable
  - `weekly` OwnedMediaWeek[]
    - `week` string, date: The Monday that starts the week
    - `citations` integer
    - `yours` integer, nullable: Null for provider=overview, whose rollups have no weekly split
    - `other` integer, nullable
  - `by_model` OwnedMediaModelShare[], nullable: Null for provider=overview
    - `model` string
    - `citations` integer
    - `share_pct` number
  - `by_country` OwnedMediaCountryShare[], nullable: Null for provider=overview
    - `country_code` string
    - `citations` integer
    - `share_pct` number
  - `content_types` OwnedMediaContentTypeShare[], nullable: Social and YouTube providers only
    - `content_type` string: reel, post or tv on Instagram, post or pulse on LinkedIn, regular, shorts or live on YouTube
    - `citations` integer
    - `share_pct` number
  - `age_buckets` OwnedMediaAgeBucketShare[], nullable: Social and YouTube providers only. Posts or videos without a known publication date are left out
    - `bucket` 'under_1m' | 'm1_6' | 'm6_12' | 'over_1y': Age of the cited post or video when the summary is read
    - `citations` integer
    - `share_pct` number
  - `stores` OwnedMediaStoreTotals[], nullable: provider=mobile_apps only
    - `store` 'google_play' | 'app_store'
    - `total` integer
    - `yours` integer
    - `share_pct` number
  - `platforms` OwnedMediaPlatformRollup[], nullable: provider=overview only, one row per platform the caller can read
    - `provider` 'youtube' | 'mobile_apps' | 'instagram' | 'facebook' | 'tiktok' | 'linkedin' | 'reddit'
    - `connected` boolean
    - `total` integer
    - `yours` integer
    - `share_pct` number
    - `weekly` object[]
      - `week` string, date
      - `citations` integer
  - `request_id` string

## Other responses

- `403`: A plan below Growth answers ERR_PLAN_REQUIRED. A team member whose permissions do not grant Owned Media (or 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/summary/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)