Posts

List posts

Returns a paginated list of posts in a workspace. Supports filtering by status, platform, social account, and date range.

get/posts

Request

  • Base URL: https://api.postplanify.com/api/v1
  • URL: https://api.postplanify.com/api/v1/posts
  • Auth: HTTP bearer

Query parameters

workspaceIdstring uuid required

Filter posts by workspace

status'SCHEDULED' | 'PUBLISHED' | 'CANCELLED' | 'RESCHEDULED'

Filter by post status

socialAccountIdstring uuid

Filter by a specific social account

platform'FACEBOOK' | 'INSTAGRAM' | 'X' | 'LINKEDIN' | 'TIKTOK' | 'YOUTUBE' | 'THREADS' | 'BLUESKY' | 'PINTEREST' | 'GOOGLE_BUSINESS'

Filter by platform

fromstring date-time

Start of date range (ISO 8601). Matches posts scheduled or published on or after this date.

tostring date-time

End of date range (ISO 8601). Matches posts scheduled or published before this date.

includeMetricsboolean

Set to true to attach each post's latest performance metrics. Off by default so listings stay light. Adds no extra requests: metrics for the whole page are fetched in a single query.

pageinteger
limitinteger

Response

Paginated list of posts

okboolean

Example response

{
  "ok": true,
  "data": [
    {
      "id": "a004b44d-2e69-4236-873a-081dc0d159a7",
      "workspaceId": "d35f525f-63e6-40ae-8946-8c120edb0225",
      "caption": "Check out our latest product launch! 🚀",
      "socialPlatformPostId": "17890523456789",
      "scheduledAt": "2026-03-01T12:00:00.000Z",
      "createdAt": "2026-02-19T10:30:00.000Z",
      "updatedAt": "2026-02-19T10:30:00.000Z",
      "socialAccount": {
        "id": "c47eb231-8eb2-4600-ac24-6951c7b5e3ce",
        "accountName": "mybrand",
        "accountUrl": "https://instagram.com/mybrand",
        "profilePictureUrl": "https://scontent.cdninstagram.com/profile.jpg",
        "customLabel": "Downtown"
      },
      "medias": [
        {
          "id": "f8a2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
          "name": "product-launch.jpg",
          "url": "https://cdn.postplanify.com/posts/all-types/product-launch.jpg",
          "type": "IMAGE_JPEG",
          "size": 245000,
          "width": 1080,
          "height": 1080
        }
      ],
      "logs": [
        {
          "type": "SUCCESS",
          "message": "Post created successfully",
          "createdAt": "2026-02-19T10:30:00.000Z"
        }
      ],
      "label": {
        "name": "Education",
        "color": "#3b82f6"
      },
      "metrics": {
        "views": 1842,
        "likes": 96,
        "comments": 12,
        "shares": 7,
        "engagementRate": 0.061,
        "platformMetrics": {
          "bookmarks": 14,
          "quotes": 3
        },
        "measuredAt": "2026-09-04"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.