REST APIGET

Get Post

Retrieve one post by ID with full per-platform status, media and scheduling details from the AdaptlyPost REST API.

GEThttps://post.adaptlypost.com/post/api/v1/social-posts/:id

Returns the full details of a specific post, including per-platform status, published URLs, and error messages if any platform failed.

API Key (Bearer token)

Permission:posts.readRoles and permissions

Platform Status

Each platform in the platforms array has its own status. A post's top-level status reflects the aggregate, it will be COMPLETED if at least one platform succeeded, PARTIAL_FAILURE if some platforms failed, and FAILED only if all platforms failed.

Response fields

Field	Description
`id`	Post ID
`userId`	The member who created the post
`status`	DRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE or FAILED
`contentType`	TEXT, IMAGE, VIDEO, CAROUSEL or DOCUMENT
`text`	The default text for every platform
`scheduledAt, timezone`	When the post is set to go out (ISO 8601), and the IANA timezone sent with it. scheduledAt is left out when the post has no time
`mediaUrls, mediaAltTexts`	The media as submitted and its alt text per image, in the same order. Shared by every platform entry
`thumbnailUrl, thumbnailTimestampMs`	The video thumbnail URL, or the frame picked as thumbnail in milliseconds, when one was sent
`recurringPostId, occurrenceAt`	Set only on a post created by a recurring series. See the section on recurring posts below
`platforms`	One entry per account the post goes to, with the fields below
`createdAt, updatedAt`	When the post was created and last changed

Platform entry fields

Field	Description
`id`	Platform entry ID. POST /api/v1/social-posts/:id/retry accepts it in platformIds
`platform`	FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST or YOUTUBE
`status`	PENDING, PUBLISHING, PUBLISHED or FAILED
`connectionId`	The account id from /social-accounts
`pageId, facebookPageExternalId`	FACEBOOK only. The Facebook page id, the same value as pageId on /social-accounts
`accountName`	Name of the connected account
`text`	The text sent to this platform, after platformTexts is applied
`platformPostId`	The post's ID on the platform, once published
`postUrl`	Public link to the published post. Set once platformPostId is known, for every platform except MASTODON
`errorMessage`	Why this platform failed
`publishedAt`	When this platform published the post
`mediaUrls, mediaAltTexts, previewUrls`	The media and alt text sent to this platform, and the previews we host. See the section on media previews below
`thumbnailUrl, thumbnailTimestampMs`	The thumbnail image or frame set for this platform through platformThumbnails. Absent when the platform uses the post thumbnail
`firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt`	The first comment set for this platform and how it went. firstCommentStatus is PENDING until the comment goes out, then PUBLISHED with firstCommentId and firstCommentPublishedAt, or FAILED with firstCommentError. A failed comment leaves the post published. All null when the platform has no first comment
`tiktokDraftFallback`	TikTok only. true when TikTok's daily direct-posting limit was hit and the content went to the TikTok inbox as a draft instead
`instagramTrialGraduation`	Instagram only. MANUAL or SS_PERFORMANCE when the reel publishes as a trial reel. See Platform Configs
`linkedinDocumentTitle`	LinkedIn only. The title of a DOCUMENT post, when one was set
`twitterKeepLinks`	X only. true when links in the X text were asked to stay clickable. Only honored for AppSumo lifetime deals
`pinterest, tiktok, instagram, facebook, youtube*`	The platform config the entry was created with, for example pinterestBoardId, tiktokPrivacyLevel, instagramPostType, facebookPostType or youtubePrivacyStatus. See Platform Configs

Media Previews

Each platform has a previewUrls array with preview images we host (WebP, up to 720px, a still frame for videos). It is filled in shortly after publishing starts and normally holds one entry per media item, where an empty string means that item could not be rendered. A post whose media had already expired gets a single cover image instead. After publishing, mediaUrls may be replaced by the platform's own CDN links, which expire within days, and the uploaded source files are removed. Use previewUrls for anything you display later.

Recurring Posts

A post created by a recurring series has two more fields. recurringPostId is the series it belongs to. occurrenceAt is the series date it fills, and it stays the same when you reschedule the post. Other posts leave both fields out. Deleting one post of a series skips that date, and the series continues.

Get a Social Post

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/post_xyz789 \
  --header 'Authorization: Bearer <api-key>'

200

{
  "id": "post_xyz789",
  "contentType": "IMAGE",
  "text": "Check out our new product launch!",
  "status": "COMPLETED",
  "scheduledAt": "2026-03-14T14:00:00Z",
  "timezone": "America/New_York",
  "mediaUrls": ["https://cdn.adaptlypost.com/social-media-posts/uuid/photo.jpg"],
  "platforms": [
    {
      "id": "pp_001",
      "platform": "TWITTER",
      "status": "PUBLISHED",
      "accountName": "@yourhandle",
      "platformPostId": "1234567890",
      "postUrl": "https://x.com/i/status/1234567890",
      "publishedAt": "2026-03-14T14:00:02Z",
      "mediaUrls": ["https://cdn.adaptlypost.com/social-media-posts/uuid/photo.jpg"],
      "previewUrls": ["https://cdn.adaptlypost.com/social-media-posts/previews/post_xyz789/1f0c9a7e2b4d6a8c0e1f.webp"]
    },
    {
      "id": "pp_003",
      "platform": "TIKTOK",
      "status": "PUBLISHED",
      "accountName": "@yourtiktok",
      "tiktokDraftFallback": true,
      "publishedAt": "2026-03-14T14:00:05Z",
      "mediaUrls": ["https://cdn.adaptlypost.com/social-media-posts/uuid/photo.jpg"],
      "previewUrls": ["https://cdn.adaptlypost.com/social-media-posts/previews/post_xyz789/1f0c9a7e2b4d6a8c0e1f.webp"]
    },
    {
      "id": "pp_002",
      "platform": "LINKEDIN",
      "status": "FAILED",
      "accountName": "Your Company",
      "errorMessage": "Image format not supported",
      "mediaUrls": ["https://cdn.adaptlypost.com/social-media-posts/uuid/photo.jpg"],
      "previewUrls": ["https://cdn.adaptlypost.com/social-media-posts/previews/post_xyz789/1f0c9a7e2b4d6a8c0e1f.webp"]
    }
  ],
  "createdAt": "2026-03-14T13:55:00Z",
  "updatedAt": "2026-03-14T14:00:10Z"
}