---
title: "Best time to post"
method: GET
path: "/api/v1/analytics/best-time-to-post"
tags: ["Analytics"]
---

# Best time to post

`GET /api/v1/analytics/best-time-to-post`

## Request

- Base URL: `https://api-app.postnext.io`
- URL: `https://api-app.postnext.io/api/v1/analytics/best-time-to-post`
- Auth: API key in header `x-api-key`

Recommended posting slots for a platform, derived from your own post
performance. Requires a paid subscription.

## Query parameters

- `platform` 'twitter' | 'instagram' | 'linkedin' | 'threads' | 'youtube' | 'tiktok' | 'bluesky', required
- `timezone` string
- `topN` integer

## Response `200`

Ranked posting-time recommendations

- object
  - `success` boolean
  - `data` BestTimeResult
    - `platform` string
    - `timezone` string
    - `sampleWindowDays` integer
    - `sampleSize` integer
    - `metricsAvailable` boolean
    - `recommendations` object[]
      - `dayOfWeek` integer: 0=Sun ... 6=Sat
      - `dayLabel` string
      - `hour` integer: 0-23, in the requested timezone
      - `score` number
      - `basedOn` object
        - `posts` integer
        - `avgEngagement` number

## Other responses

- `401`: Missing or invalid API key

---

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