List posts - TryPost Docs

curl -X GET https://app.trypost.it/api/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "content": "Excited to announce our new feature!",
      "media": [],
      "status": "scheduled",
      "scheduled_at": "2025-01-15 10:00:00",
      "published_at": null,
      "platforms": [
        {
          "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
          "platform": "linkedin",
          "content_type": "linkedin_post",
          "status": "pending",
          "enabled": true,
          "platform_url": null,
          "published_at": null,
          "error_message": null,
          "display_name": "John Doe",
          "display_username": "johndoe",
          "display_avatar": "https://media.licdn.com/.../avatar.jpg",
          "social_account": {
            "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
            "platform": "linkedin",
            "display_name": "John Doe",
            "username": "johndoe",
            "is_active": true,
            "status": "connected"
          }
        }
      ],
      "labels": [],
      "created_at": "2025-01-14 09:00:00",
      "updated_at": "2025-01-14 09:00:00"
    }
  ],
  "links": {
    "first": "https://app.trypost.it/api/posts?page=1",
    "last":  "https://app.trypost.it/api/posts?page=1",
    "prev":  null,
    "next":  null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "to": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "path": "https://app.trypost.it/api/posts",
    "links": [
      { "url": null, "label": "&laquo; Previous", "page": null, "active": false },
      { "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
      { "url": null, "label": "Next &raquo;", "page": null, "active": false }
    ]
  }
}

GET

posts

curl -X GET https://app.trypost.it/api/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "content": "Excited to announce our new feature!",
      "media": [],
      "status": "scheduled",
      "scheduled_at": "2025-01-15 10:00:00",
      "published_at": null,
      "platforms": [
        {
          "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
          "platform": "linkedin",
          "content_type": "linkedin_post",
          "status": "pending",
          "enabled": true,
          "platform_url": null,
          "published_at": null,
          "error_message": null,
          "display_name": "John Doe",
          "display_username": "johndoe",
          "display_avatar": "https://media.licdn.com/.../avatar.jpg",
          "social_account": {
            "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
            "platform": "linkedin",
            "display_name": "John Doe",
            "username": "johndoe",
            "is_active": true,
            "status": "connected"
          }
        }
      ],
      "labels": [],
      "created_at": "2025-01-14 09:00:00",
      "updated_at": "2025-01-14 09:00:00"
    }
  ],
  "links": {
    "first": "https://app.trypost.it/api/posts?page=1",
    "last":  "https://app.trypost.it/api/posts?page=1",
    "prev":  null,
    "next":  null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "to": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "path": "https://app.trypost.it/api/posts",
    "links": [
      { "url": null, "label": "&laquo; Previous", "page": null, "active": false },
      { "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
      { "url": null, "label": "Next &raquo;", "page": null, "active": false }
    ]
  }
}

Request

page

integer

Page number for pagination. Defaults to 1.

Response

Returns posts ordered by scheduled_at descending (latest first), 15 per page.

data

array

Show child attributes

string

UUID of the post.

content

string

The post text body. May be null for drafts.

media

array

Media items attached to the post. Each item has id, path, url, type (image | video), mime_type, original_filename. Empty array if none.

status

string

One of: draft, scheduled, publishing, published, partially_published, failed.

scheduled_at

string

Scheduled publish time in Y-m-d H:i:s format. May be null for unscheduled drafts.

published_at

string

Publish completion time in Y-m-d H:i:s format. null until fully published.

platforms

array

One entry per post_platform (one social account targeted by this post).

Show child attributes

string

UUID of the post_platform row. Use this in PUT /posts/{post} to enable/disable platforms.

platform

string

Platform identifier — e.g. linkedin, linkedin-page, x, facebook, instagram, instagram-facebook, tiktok, youtube, threads, pinterest, bluesky, mastodon.

content_type

string

Format used for this platform — e.g. linkedin_post, instagram_reel. See GET /content-types.

status

string

Per-platform publish status: pending, publishing, published, or failed.

enabled

boolean

Whether this platform will be published to.

platform_url

string

Public URL of the published post. null until published successfully.

published_at

string

Per-platform publish time in Y-m-d H:i:s format. null until published.

error_message

string

Error reason from the last failed publish attempt. null on success.

display_name

string

Snapshot of the social account’s display name (preserved if the account is later disconnected).

display_username

string

Snapshot of the username/handle.

display_avatar

string

Snapshot URL of the avatar.

The connected social account. Fields: id, platform, display_name, username, is_active, status (connected | disconnected | token_expired).

labels

array

Workspace labels attached to the post. Each item has id, name, color, created_at, updated_at.

created_at

string

Creation timestamp in Y-m-d H:i:s format.

updated_at

string

Last update timestamp in Y-m-d H:i:s format.

curl -X GET https://app.trypost.it/api/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "9f1a2b3c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
      "content": "Excited to announce our new feature!",
      "media": [],
      "status": "scheduled",
      "scheduled_at": "2025-01-15 10:00:00",
      "published_at": null,
      "platforms": [
        {
          "id": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
          "platform": "linkedin",
          "content_type": "linkedin_post",
          "status": "pending",
          "enabled": true,
          "platform_url": null,
          "published_at": null,
          "error_message": null,
          "display_name": "John Doe",
          "display_username": "johndoe",
          "display_avatar": "https://media.licdn.com/.../avatar.jpg",
          "social_account": {
            "id": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
            "platform": "linkedin",
            "display_name": "John Doe",
            "username": "johndoe",
            "is_active": true,
            "status": "connected"
          }
        }
      ],
      "labels": [],
      "created_at": "2025-01-14 09:00:00",
      "updated_at": "2025-01-14 09:00:00"
    }
  ],
  "links": {
    "first": "https://app.trypost.it/api/posts?page=1",
    "last":  "https://app.trypost.it/api/posts?page=1",
    "prev":  null,
    "next":  null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "to": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1,
    "path": "https://app.trypost.it/api/posts",
    "links": [
      { "url": null, "label": "&laquo; Previous", "page": null, "active": false },
      { "url": "https://app.trypost.it/api/posts?page=1", "label": "1", "page": 1, "active": true },
      { "url": null, "label": "Next &raquo;", "page": null, "active": false }
    ]
  }
}

Introduction Get post

​Request

​Response

Request

Response