---
title: "List posts"
method: GET
path: "/v2/posts"
tags: ["publishing"]
---

# List posts

`GET /v2/posts`

Lists the current user's posts (scheduled, published, and failed) within a time window, ordered by post time (most recent first). Supports cursor-based pagination and filtering by status and platform. Post listing has a user-level rate limit of **60 requests / minute**.

## Query parameters

- `since` string
- `until` string
- `limit` integer
- `cursor` string
- `status` string[]
- `platform` string[]
- `source` 'blotato' | 'all'

## Response `200`

Default Response

- object
  - `items` object[], required — List of posts
    - `id` string, required
    - `postTime` string, required
    - `state` union, required
      - object
        - `type` 'scheduled', required
      - object
        - `type` 'published', required
        - `postUrl` string, nullable, required
      - object
        - `type` 'failed', required
        - `errorMessage` string, nullable, required
    - `text` string, required — The text content of the post.
    - `mediaUrls` string[], required — List of media URLs to include in the post.
    - `platform` 'twitter' | 'instagram' | 'linkedin' | 'facebook' | 'tiktok' | 'pinterest' | 'threads' | 'bluesky' | 'youtube' | 'other', required — Social media platform
  - `cursor` string — Cursor for the next page. Absent when there are no more posts.

## Other responses

- `403` — Forbidden
- `422` — Validation error
- `500` — Server error

---

[API](https://skmtc.net/blotato/apis/blotato-api.md) · [All operations](https://skmtc.net/blotato/apis/blotato-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blotato/blotato-api/revisions/c93447ba6b9d/schema)