---
title: "The same metrics as the overview, one row per platform"
method: GET
path: "/analytics/platform-breakdown"
tags: ["Analytics"]
---

# The same metrics as the overview, one row per platform

`GET /analytics/platform-breakdown`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/analytics/platform-breakdown`
- Auth: HTTP bearer

One entry per platform that has analytics data in the workspace, each with the metrics of /analytics/overview scoped to that platform and a `supportedMetrics` list naming the metrics the platform actually reports.. Requires the `analytics.read` permission.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `connectionIds` string[]

## Headers

- `X-Workspace-Id` string

## Response `200`

Per-platform metrics

- object
  - `platforms` AnalyticsPlatformBreakdownItem[]
    - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'THREADS' | 'TIKTOK' | 'TWITTER' | 'BLUESKY' | 'LINKEDIN' | 'PINTEREST' | 'YOUTUBE' | 'MASTODON' | 'TELEGRAM' | 'GOOGLE_BUSINESS' | 'TUMBLR'
    - `followers` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `views` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `likes` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `comments` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `shares` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `postsCount` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `avgViewsPerPost` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `engagementRate` AnalyticsMetricValue: A metric for the requested window next to the same metric for the previous window of equal length. `null` when no selected platform reports it
      - `value` number, nullable
      - `previousValue` number, nullable
      - `deltaPercent` number, nullable: Percentage change from previousValue to value. Null when previousValue is 0 or unknown
    - `supportedMetrics` string[]: Metric names this platform reports

## Other responses

- `400`: Validation error
- `401`: Invalid or missing API key
- `403`: The key's role does not hold `analytics.read`
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)