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

# Social Total Impressions

`GET /api/social/analytics/impressions`

Total impressions for the profile over 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=, so summing it is both correct and cheap.

## 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/fastapi.md) · [All operations](https://skmtc.dev/openshorts/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openshorts/fastapi/revisions/8085a0ce516b/schema)