---
title: "Best-performing deliveries"
method: GET
path: "/top-posts"
---

# Best-performing deliveries

`GET /top-posts`

## Request

- Base URL: `https://xpost.to/api/v1`
- URL: `https://xpost.to/api/v1/top-posts`
- Auth: HTTP bearer

Deliveries ranked by a metric over the window — study these before drafting to learn what works for this audience.

## Query parameters

- `metric` 'engagement' | 'views' | 'likes' | 'comments' | 'shares' | 'reach' | 'saves'
- `since_days` integer
- `limit` integer
- `platform` string
- `format` 'feed' | 'reel' | 'story'

## Response `200`

Ranked deliveries

- object
  - `metric` string
  - `since_days` integer
  - `data` unknown[]
    - unknown

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limited

---

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