---
title: "Get the top posts"
method: GET
path: "/insights/posts/top_posts"
tags: ["Insights"]
---

# Get the top posts

`GET /insights/posts/top_posts`

## Request

- Base URL: `https://socialbu.com/api/v1`
- URL: `https://socialbu.com/api/v1/insights/posts/top_posts`
- Auth: HTTP bearer

Returns top posts published on the requested calendar dates in the authenticated user's timezone, ranked by specified metrics from Analytics-permitted accounts.

## Query parameters

- `limit` integer
- `start` string, date, required
- `end` string, date, required
- `metrics` union, required
  - string
  - string[]
- `accounts` integer[]
- `team` integer

## Response `200`

successful operation

- object
  - `data` unknown[]: Array of all top posts.
    - unknown

## Other responses

- `404`: Resource not found

---

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