Sign in

v1

latestOpenAPI 3.1.02026-07-17747116.5 KB
Drafts

List posts

List posts for an account.

get/v1/posts

Query parameters

accountinteger required

Account ID to list posts for

status'DRAFT' | 'SCHEDULED' | 'PUBLISHING' | 'PUBLISHED' nullable

Optional status filter

tag_idinteger nullable

Optional tag ID filter

pageinteger

Page number

sizeinteger

Items per page

Response

OK

countinteger required
limitinteger required
offsetinteger required
nextstring nullable required
previousstring nullable required

Example response

{
  "results": [
    {
      "social_set_id": 67890,
      "share_url": "https://app.postey.ai/share/abc123",
      "private_url": "https://app.postey.ai/?d=12345&a=67890",
      "tags": [
        "marketing",
        "product"
      ],
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-16T09:15:00Z",
      "published_at": "2025-01-20T14:00:05Z",
      "mastodon_post_published_at": "2025-01-20T14:00:05Z",
      "linkedin_post_published_at": "2025-01-20T14:00:05Z",
      "threads_post_published_at": "2025-01-20T14:00:05Z",
      "bluesky_post_published_at": "2025-01-20T14:00:05Z",
      "x_post_published_at": "2025-01-20T14:00:05Z",
      "x_published_url": "https://x.com/username/status/1234567890",
      "linkedin_published_url": "https://www.linkedin.com/feed/update/urn:li:share:1234567890"
    }
  ]
}