---
title: "Social Total Impressions"
method: GET
path: "/api/social/analytics/impressions"
---

# Social Total Impressions

`GET /api/social/analytics/impressions`

## Request

- Base URL: `https://api.openshorts.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openshorts.app/api/social/analytics/impressions`
- Auth: none declared

Views of the posts published through OpenShorts in a window.

Computed by aggregating the profile-scoped post cache instead of proxying
Upload-Post's /total-impressions: that endpoint echoes the requested
profile but returns account-wide numbers (observed 2026-08-21 — a profile
with zero posts got 85K Instagram impressions), which for managed users
would leak other tenants' aggregates. The cache endpoint IS scoped by
?user=, but its ``since`` is the snapshot date and it carries the creator's
native posts too: social_metrics.summarise keeps only our posts published
in the window, latest snapshot each.

## Query parameters

- `period` string, nullable
- `start_date` string, nullable
- `end_date` string, nullable
- `platform` string, nullable
- `breakdown` boolean, nullable
- `user` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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