---
title: "List performance by platform"
method: GET
path: "/v2/analytics/platforms"
tags: ["analytics"]
---

# List performance by platform

`GET /v2/analytics/platforms`

## Request

- Base URL: `https://backend.blotato.com`
- URL: `https://backend.blotato.com/v2/analytics/platforms`
- Auth: API key in header `blotato-api-key`

Returns engagement and view totals per platform for the user's posts published in the given time range, based on the latest analytics snapshot of each post.

## Query parameters

- `since` string
- `until` string
- `bucket` 'hour' | 'day'

## Response `200`

Default Response

- object
  - `items` object[], required: One entry per platform with analytics, most engagements first.
    - `platform` 'twitter' | 'instagram' | 'linkedin' | 'facebook' | 'tiktok' | 'pinterest' | 'threads' | 'bluesky' | 'youtube' | 'other', required: Social media platform
    - `postsCount` integer, required: Number of posts published in the window that have analytics.
    - `engagementsCount` string, required: Sum of likes, comments (or replies), shares, and saves on the latest snapshot of each post.
    - `likesCount` string, required: Sum of likes on the latest snapshot of each post.
    - `commentsCount` string, required: Sum of comments (or replies) on the latest snapshot of each post.
    - `viewsCount` string, nullable, required: Sum of views (or impressions) on the latest snapshot of each post. Null if the platform does not report either.
    - `buckets` object[], required: Metrics of the posts published in each bucket, oldest first. Buckets without posts are omitted.
      - `start` string, required: ISO 8601 start of the bucket (UTC).
      - `engagementsCount` string, required
      - `likesCount` string, required
      - `commentsCount` string, required
      - `viewsCount` string, nullable, required

## Other responses

- `403`: Forbidden
- `422`: Validation error
- `500`: Server error

## Changes

- **2026-09-29** `4125ac343d44`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/blotato/apis/blotato-api/changes/v2/analytics/platforms/get.md)

---

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