---
title: "Metrics bucketed by day, week or month"
method: GET
path: "/analytics/timeseries"
tags: ["Analytics"]
---

# Metrics bucketed by day, week or month

`GET /analytics/timeseries`

## Request

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

One point per bucket inside the window. `followers` is the latest known count at the end of each bucket; the other counters sum posts published inside the bucket. A metric no selected platform reports is `null`.. Requires the `analytics.read` permission.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `platforms` string[]
- `connectionIds` string[]
- `granularity` 'DAILY' | 'WEEKLY' | 'MONTHLY'

## Headers

- `X-Workspace-Id` string

## Response `200`

Timeseries points

- object
  - `points` AnalyticsTimeseriesPoint[]
    - `date` string, date-time: Start of the bucket (UTC)
    - `views` number, nullable
    - `likes` number, nullable
    - `comments` number, nullable
    - `shares` number, nullable
    - `followers` number, nullable: Latest known follower count at the end of the bucket
    - `postsCount` number, nullable
    - `engagementRate` number, nullable

## 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)