Get Post
Retrieve one post by ID with full per-platform status, media and scheduling details from the AdaptlyPost REST API.
https://post.adaptlypost.com/post/api/v1/social-posts/:idReturns the full details of a specific post, including per-platform status, published URLs, and error messages if any platform failed.
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 without its own media in platformMedia |
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. A story added with shareToStory is an entry of its own, with instagramPostType or facebookPostType STORY |
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, YOUTUBE, GOOGLE_BUSINESS, TUMBLR, WORDPRESS or TELEGRAM |
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 the platform has published it, on every platform. Instagram and Facebook stories expire after 24 hours, so for them it links to the profile or page that posted them |
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 |
mediaOverrideUrls, mediaOverrideAltTexts | The media and alt text set for this platform through platformMedia. Empty when the platform uses the post media. mediaUrls holds what this platform publishes either way |
thumbnailUrl, thumbnailTimestampMs | The thumbnail image or frame set for this platform through platformThumbnails. Absent when the platform uses the post thumbnail |
mediaAspectRatio, mediaAspectRatioFit | The shape set for this platform through platformAspectRatios (SQUARE, PORTRAIT, VERTICAL or LANDSCAPE) and how it was reached (CROP or PAD). Absent when the images went out as uploaded |
firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt, firstCommentDelayMinutes, firstCommentDueAt | 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. firstCommentDelayMinutes is the delay set on the comment. firstCommentDueAt is when a PENDING comment goes out, set once the platform publishes |
threadReplies, threadReplyMediaUrls, threadStatus, threadReplyIds, threadError, threadPublishedAt | The thread set for this platform and how far it got. threadReplyMediaUrls holds the image URLs of each reply, parallel to threadReplies. threadStatus is PENDING until every reply goes out, then PUBLISHED with threadPublishedAt, or FAILED with threadError. threadReplyIds lists the ids of the replies posted so far (AT URIs on Bluesky). A failed thread leaves the post published. threadReplies and threadReplyMediaUrls are empty and the rest null when the platform has no thread |
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 |
instagramCollaborators | Instagram only. The usernames invited as collaborators. See Platform Configs |
instagramUserTags | Instagram only. The accounts tagged in the media, each with username, x and y. See Platform Configs |
instagramUntaggedUsernames | Instagram only. Tagged accounts Instagram refused because they are private or don't exist. The post went out without its tags |
instagramUsername | Instagram only. The Instagram handle the entry was published from, set once it publishes |
instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolume | Instagram only. The audio added to the Reel through instagramConfigs[].audio, with its title, artist and both volumes |
facebookTextFormatPresetId | Facebook only. The text background sent with the post. See Platform Configs |
facebookImageLayout | Facebook only. GRID or CAROUSEL, when one was set. See Platform Configs |
facebookCarouselCards | Facebook only. The carousel cards, one per image, each with link, title and description. See Platform Configs |
linkedinDocumentTitle | LinkedIn only. The title of a DOCUMENT post, when one was set |
linkedinReshareOf | LinkedIn only. The URN of the post this one reshares (urn:li:share:... or urn:li:ugcPost:...), when it is a reshare |
twitterKeepLinks | X only. true when links in the X text were asked to stay clickable. Only honored for AppSumo lifetime deals |
twitterQuoteOf | X only. The ID of the post this one quotes, when it is a quote |
googleBusiness* | Google Business Profile only. The post type, button, event and offer settings from googleBusinessConfigs, for example googleBusinessTopicType, googleBusinessCallToActionType or googleBusinessEventStart. See Platform Configs |
wordpressTitle, wordpressExcerpt, wordpressCategoryIds, wordpressTags, wordpressStatus | WordPress only. The title, excerpt, category ids and tags the post was sent with. See Platform Configs wordpressStatus is PUBLISH, DRAFT or PENDING. |
tumblrTags, tumblrTitle, tumblrSourceUrl | Tumblr only. The tags, title and source link the post was sent with. See Platform Configs |
youtubeDefaultAudioLanguage | YouTube only. The language of the video's original audio, when one was set. See Platform Configs |
youtubeScheduleOnYouTube, youtubeScheduledVideoId | YouTube only. youtubeScheduleOnYouTube is true when the post asked to be scheduled on YouTube. youtubeScheduledVideoId is the video uploaded ahead of scheduledAt; while it is set and the entry is not published, the post can't be updated or unscheduled. See Platform Configs |
instagramAiGenerated, facebookAiGenerated, youtubeAiGenerated | true when the post carries the platform's AI label: Instagram's and Facebook's AI info label, YouTube's altered or synthetic content label. See Platform Configs |
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.
curl --request GET \
--url https://post.adaptlypost.com/post/api/v1/social-posts/post_xyz789 \
--header 'Authorization: Bearer <api-key>'{
"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"
}