---
title: "Get analytics summary"
method: GET
path: "/v2/analytics/summary"
tags: ["analytics"]
---

# Get analytics summary

`GET /v2/analytics/summary`

## Request

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

Returns published and failed post counts (in total, per platform, and per time bucket) and metric totals for the user's posts published in the given time range.

## Query parameters

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

## Response `200`

Default Response

- object
  - `publishedCount` integer, required: Number of posts published through Blotato in the window.
  - `failedCount` integer, required: Number of posts that failed to publish in the window.
  - `metrics` object, nullable, required: Totals from the latest analytics snapshot of each post published in the window. Null if the user does not have analytics enabled.
    - `postsCount` integer, required: Number of posts published in the window that have analytics.
    - `viewsCount` string, required: Sum of views (or impressions) 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.
  - `platforms` object[], required: Published and failed posts per platform, most posts first. Platforms without posts are omitted.
    - `platform` 'twitter' | 'instagram' | 'linkedin' | 'facebook' | 'tiktok' | 'pinterest' | 'threads' | 'bluesky' | 'youtube' | 'other', required: Social media platform
    - `publishedCount` integer, required
    - `failedCount` integer, required
  - `buckets` object[], required: Published and failed posts in each bucket, oldest first. Buckets without posts are omitted.
    - `start` string, required: ISO 8601 start of the bucket (UTC).
    - `publishedCount` integer, required
    - `failedCount` integer, 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/summary/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)