{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/llmpulse-ai/json-schema/llmpulse-ai-owned-media-summary-response-schema.json",
  "title": "OwnedMediaSummaryResponse",
  "x-generated": "2026-11-17",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/llmpulse-ai-openapi.json#/components/schemas/OwnedMediaSummaryResponse",
  "type": "object",
  "properties": {
    "project_id": {
      "type": "integer"
    },
    "provider": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "to": {
      "type": "string",
      "format": "date-time"
    },
    "connected": {
      "type": "boolean",
      "description": "Whether a profile is claimed on the platform (on overview, on any platform)"
    },
    "kpis": {
      "$ref": "#/$defs/OwnedMediaKpis"
    },
    "previous": {
      "type": "object",
      "description": "The period of the same length that ends just before from",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        },
        "kpis": {
          "$ref": "#/$defs/OwnedMediaKpis"
        }
      }
    },
    "changes": {
      "$ref": "#/$defs/OwnedMediaKpiChanges"
    },
    "weekly": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/OwnedMediaWeek"
      }
    },
    "by_model": {
      "type": [
        "array",
        "null"
      ],
      "description": "Null for provider=overview",
      "items": {
        "$ref": "#/$defs/OwnedMediaModelShare"
      }
    },
    "by_country": {
      "type": [
        "array",
        "null"
      ],
      "description": "Null for provider=overview",
      "items": {
        "$ref": "#/$defs/OwnedMediaCountryShare"
      }
    },
    "content_types": {
      "type": [
        "array",
        "null"
      ],
      "description": "Social and YouTube providers only",
      "items": {
        "$ref": "#/$defs/OwnedMediaContentTypeShare"
      }
    },
    "age_buckets": {
      "type": [
        "array",
        "null"
      ],
      "description": "Social and YouTube providers only. Posts or videos without a known publication date are left out",
      "items": {
        "$ref": "#/$defs/OwnedMediaAgeBucketShare"
      }
    },
    "stores": {
      "type": [
        "array",
        "null"
      ],
      "description": "provider=mobile_apps only",
      "items": {
        "$ref": "#/$defs/OwnedMediaStoreTotals"
      }
    },
    "platforms": {
      "type": [
        "array",
        "null"
      ],
      "description": "provider=overview only, one row per platform the caller can read",
      "items": {
        "$ref": "#/$defs/OwnedMediaPlatformRollup"
      }
    },
    "activity": {
      "type": "array",
      "description": "All providers. One row per actual project reporting period with runs; provider=overview has null yours and other, and provider=reddit also returns positive, neutral and negative sentiment counts. Citation counts use the selected date window, and periods with runs but no citation have zero",
      "items": {
        "$ref": "#/$defs/OwnedMediaSummaryActivityPeriod"
      }
    },
    "subreddit_activity": {
      "type": "array",
      "description": "provider=reddit only. One row per subreddit and actual reporting period; the top five subreddits are separate and Others has a null subreddit",
      "items": {
        "$ref": "#/$defs/RedditSubredditActivityPeriod"
      }
    },
    "positions": {
      "type": "array",
      "description": "provider=reddit only. Position distribution over the selected date window",
      "items": {
        "$ref": "#/$defs/RedditPositionShare"
      }
    },
    "brand_share": {
      "type": "array",
      "description": "provider=reddit only. Citation share among the tracked brand and competitors with cited mentions",
      "items": {
        "$ref": "#/$defs/RedditBrandShare"
      }
    },
    "replies": {
      "$ref": "#/$defs/TrustpilotReplies"
    },
    "request_id": {
      "type": "string"
    }
  },
  "$defs": {
    "OwnedMediaAgeBucketShare": {
      "type": "object",
      "properties": {
        "bucket": {
          "type": "string",
          "enum": [
            "under_1m",
            "m1_6",
            "m6_12",
            "over_1y"
          ],
          "description": "Age of the cited post or video when the summary is read"
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        }
      }
    },
    "OwnedMediaContentTypeShare": {
      "type": "object",
      "properties": {
        "content_type": {
          "type": "string",
          "description": "reel, post or tv on Instagram, post or pulse on LinkedIn, regular, shorts or live on YouTube"
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        }
      }
    },
    "OwnedMediaCountryShare": {
      "type": "object",
      "properties": {
        "country_code": {
          "type": "string"
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        }
      }
    },
    "OwnedMediaKpiChanges": {
      "type": "object",
      "description": "Change against the previous period. Counts in percent, share_pct and positive_pct in percentage points; null when the previous period has nothing to compare with",
      "properties": {
        "total": {
          "type": [
            "number",
            "null"
          ]
        },
        "yours": {
          "type": [
            "number",
            "null"
          ]
        },
        "your_profile": {
          "type": [
            "number",
            "null"
          ]
        },
        "your_content": {
          "type": [
            "number",
            "null"
          ]
        },
        "share_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "unique_subreddits": {
          "type": [
            "number",
            "null"
          ],
          "description": "Percent change in unique subreddits; null when the previous value cannot be compared"
        },
        "unique_authors": {
          "type": [
            "number",
            "null"
          ],
          "description": "Percent change in unique authors; null when the previous value cannot be compared"
        },
        "positive_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Percentage-point change in positive sentiment; null when the previous period has no citations"
        }
      }
    },
    "OwnedMediaKpis": {
      "type": "object",
      "properties": {
        "total": {
          "type": "integer",
          "description": "Citations of the platform in the window, yours and everyone else's"
        },
        "yours": {
          "type": "integer",
          "description": "Citations of your own profiles and their content"
        },
        "your_profile": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Citations of your profile or channel pages. Null for mobile_apps and overview"
        },
        "your_content": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Citations of your posts or videos. Null for mobile_apps and overview"
        },
        "share_pct": {
          "type": "number",
          "description": "yours as a percentage of total (0-100)"
        },
        "unique_subreddits": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Number of cited subreddits (provider=reddit; null or omitted for other providers)"
        },
        "unique_authors": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Number of cited Reddit authors (provider=reddit; null or omitted for other providers)"
        },
        "positive_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "Positive sentiment among rated Reddit citations, as a percentage (provider=reddit; null or omitted for other providers)"
        }
      }
    },
    "OwnedMediaModelShare": {
      "type": "object",
      "properties": {
        "model": {
          "type": "string"
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        }
      }
    },
    "OwnedMediaPlatformActivityPeriod": {
      "type": "object",
      "required": [
        "date",
        "citations"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Start date of the actual reporting period"
        },
        "citations": {
          "type": "integer"
        }
      }
    },
    "OwnedMediaPlatformRollup": {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "enum": [
            "youtube",
            "mobile_apps",
            "instagram",
            "facebook",
            "tiktok",
            "linkedin",
            "trustpilot",
            "reddit"
          ]
        },
        "connected": {
          "type": "boolean"
        },
        "total": {
          "type": "integer"
        },
        "yours": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        },
        "weekly": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "week": {
                "type": "string",
                "format": "date"
              },
              "citations": {
                "type": "integer"
              }
            }
          }
        },
        "activity": {
          "type": "array",
          "description": "One date/citation row per actual project tracking period with runs",
          "items": {
            "$ref": "#/$defs/OwnedMediaPlatformActivityPeriod"
          }
        }
      }
    },
    "OwnedMediaStoreTotals": {
      "type": "object",
      "properties": {
        "store": {
          "type": "string",
          "enum": [
            "google_play",
            "app_store"
          ]
        },
        "total": {
          "type": "integer"
        },
        "yours": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number"
        }
      }
    },
    "OwnedMediaSummaryActivityPeriod": {
      "type": "object",
      "required": [
        "date",
        "citations",
        "yours",
        "other"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Start date of the actual reporting period"
        },
        "citations": {
          "type": "integer"
        },
        "yours": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Citations on owned profiles and content, null for provider=overview"
        },
        "other": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Citations not counted as yours, null for provider=overview"
        },
        "positive": {
          "type": "integer",
          "description": "Citations whose AI answer sentiment is positive"
        },
        "neutral": {
          "type": "integer",
          "description": "Citations whose AI answer sentiment is neutral or mixed"
        },
        "negative": {
          "type": "integer",
          "description": "Citations whose AI answer sentiment is negative"
        }
      }
    },
    "OwnedMediaWeek": {
      "type": "object",
      "properties": {
        "week": {
          "type": "string",
          "format": "date",
          "description": "The Monday that starts the week"
        },
        "citations": {
          "type": "integer"
        },
        "yours": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Null for provider=overview, whose rollups have no weekly split"
        },
        "other": {
          "type": [
            "integer",
            "null"
          ]
        }
      }
    },
    "RedditBrandShare": {
      "type": "object",
      "required": [
        "actor_id",
        "actor_name",
        "is_brand",
        "citations",
        "share_pct"
      ],
      "properties": {
        "actor_id": {
          "type": "integer"
        },
        "actor_name": {
          "type": [
            "string",
            "null"
          ]
        },
        "is_brand": {
          "type": "boolean"
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number",
          "description": "Percentage (0-100) among the tracked brand and competitors with cited mentions"
        }
      }
    },
    "RedditPositionShare": {
      "type": "object",
      "required": [
        "bucket",
        "citations",
        "share_pct"
      ],
      "properties": {
        "bucket": {
          "type": "string",
          "enum": [
            "position_1",
            "position_2_3",
            "position_4_7",
            "position_7_plus"
          ]
        },
        "citations": {
          "type": "integer"
        },
        "share_pct": {
          "type": "number",
          "description": "Percentage (0-100) of citations in the included position buckets"
        }
      }
    },
    "RedditSubredditActivityPeriod": {
      "type": "object",
      "required": [
        "date",
        "subreddit",
        "is_others",
        "citations"
      ],
      "properties": {
        "date": {
          "type": "string",
          "format": "date",
          "description": "Start date of the actual reporting period"
        },
        "subreddit": {
          "type": [
            "string",
            "null"
          ],
          "description": "Subreddit name, or null for the Others aggregate"
        },
        "is_others": {
          "type": "boolean"
        },
        "citations": {
          "type": "integer"
        }
      }
    },
    "TrustpilotReplies": {
      "type": "object",
      "description": "provider=trustpilot only. How the brand answers its Trustpilot reviews, on the profile of the project's own domain, among the reviews LLM Pulse holds for it (the newest ones from each monthly read, not every review on Trustpilot), whatever the date window. Every field is null until the profile has been read",
      "properties": {
        "reviews_held": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Reviews held for the profile"
        },
        "replied_count": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Reviews held that the brand replied to"
        },
        "not_replied_count": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Reviews held that the brand has not replied to"
        },
        "reply_rate_pct": {
          "type": [
            "number",
            "null"
          ],
          "description": "replied_count over reviews_held, on a 0-100 scale; null when no review is held"
        },
        "median_reply_hours": {
          "type": [
            "number",
            "null"
          ],
          "description": "Median hours from publication to reply over the replied reviews held that carry both dates (a reply dated before its review is left out); null when there is none"
        }
      }
    }
  }
}