Pobierz post
Pobierz jeden post według ID wraz z pełnym statusem na każdej platformie, multimediami i szczegółami planowania za pomocą REST API AdaptlyPost.
https://post.adaptlypost.com/post/api/v1/social-posts/:idZwraca wszystkie dane posta, w tym status na każdej platformie, adresy URL publikacji i komunikaty o błędach, jeśli którakolwiek platforma zawiodła.
Status platformy
Każda platforma w tablicy platforms ma własny status. Status główny posta jest ich podsumowaniem: COMPLETED, jeśli powiodło się co najmniej na jednej platformie, PARTIAL_FAILURE, jeśli niektóre platformy zawiodły, i FAILED tylko wtedy, gdy zawiodły wszystkie.
Pola odpowiedzi
| Pole | Opis |
|---|---|
id | ID posta |
userId | Członek, który utworzył post |
status | DRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE lub FAILED |
contentType | TEXT, IMAGE, VIDEO, CAROUSEL lub DOCUMENT |
text | Domyślny tekst dla wszystkich platform |
scheduledAt, timezone | Termin publikacji posta (ISO 8601) i wysłana z nim strefa czasowa IANA. scheduledAt jest pomijane, gdy post nie ma terminu |
mediaUrls, mediaAltTexts | Przesłane multimedia i tekst alternatywny każdego obrazu, w tej samej kolejności. Wspólne dla wszystkich wpisów platform bez własnych multimediów w platformMedia |
thumbnailUrl, thumbnailTimestampMs | Adres URL miniatury filmu lub klatka wybrana jako miniatura, w milisekundach, jeśli ją wysłano |
recurringPostId, occurrenceAt | Ustawiane tylko dla posta utworzonego przez serię cykliczną. Zob. sekcję o postach cyklicznych poniżej |
platforms | Jeden wpis na konto, na które trafia post, z polami opisanymi poniżej. Relacja dodana przez shareToStory jest osobnym wpisem z instagramPostType lub facebookPostType STORY |
createdAt, updatedAt | Data utworzenia i ostatniej zmiany posta |
Pola wpisu platformy
| Pole | Opis |
|---|---|
id | ID wpisu platformy. POST /api/v1/social-posts/:id/retry przyjmuje je w platformIds |
platform | FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST, YOUTUBE, GOOGLE_BUSINESS, TUMBLR, WORDPRESS lub TELEGRAM |
status | PENDING, PUBLISHING, PUBLISHED lub FAILED |
connectionId | Id konta z /social-accounts |
pageId, facebookPageExternalId | Tylko FACEBOOK. Id strony na Facebooku, ta sama wartość co pageId w /social-accounts |
accountName | Nazwa połączonego konta |
text | Tekst wysłany na tę platformę, po zastosowaniu platformTexts |
platformPostId | ID posta na platformie, po publikacji |
postUrl | Publiczny link do opublikowanego posta, ustawiany po publikacji na każdej platformie. Relacje na Instagramie i Facebooku wygasają po 24 godzinach, więc w ich przypadku link prowadzi do profilu lub strony, która je opublikowała |
errorMessage | Przyczyna niepowodzenia na tej platformie |
publishedAt | Moment publikacji posta na tej platformie |
mediaUrls, mediaAltTexts, previewUrls | Multimedia i tekst alternatywny wysłane na tę platformę oraz hostowane przez nas podglądy. Zob. sekcję o podglądach multimediów poniżej |
mediaOverrideUrls, mediaOverrideAltTexts | Multimedia i tekst alternatywny ustawione dla tej platformy przez platformMedia. Puste, gdy platforma używa multimediów posta. mediaUrls zawsze zawiera to, co publikuje ta platforma |
thumbnailUrl, thumbnailTimestampMs | Obraz lub klatka miniatury ustawione dla tej platformy przez platformThumbnails. Brak, gdy platforma używa miniatury posta |
mediaAspectRatio, mediaAspectRatioFit | Kształt ustawiony dla tej platformy przez platformAspectRatios (SQUARE, PORTRAIT, VERTICAL lub LANDSCAPE) i sposób jego uzyskania (CROP lub PAD). Brak, gdy obrazy opublikowano w przesłanej postaci |
firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt, firstCommentDelayMinutes, firstCommentDueAt | Pierwszy komentarz ustawiony dla tej platformy i jego wynik. firstCommentStatus ma wartość PENDING do czasu publikacji komentarza, potem PUBLISHED z firstCommentId i firstCommentPublishedAt lub FAILED z firstCommentError. Nieudany komentarz nie cofa publikacji posta. Wszystkie pola mają wartość null, gdy platforma nie ma pierwszego komentarza. firstCommentDelayMinutes to opóźnienie komentarza. firstCommentDueAt to termin publikacji komentarza PENDING, ustawiany po publikacji na platformie |
threadReplies, threadReplyMediaUrls, threadStatus, threadReplyIds, threadError, threadPublishedAt | Wątek ustawiony dla tej platformy i jego postęp. threadReplyMediaUrls zawiera adresy URL obrazów każdej odpowiedzi, w kolejności threadReplies. threadStatus ma wartość PENDING do publikacji wszystkich odpowiedzi, potem PUBLISHED z threadPublishedAt lub FAILED z threadError. threadReplyIds zawiera id dotychczas opublikowanych odpowiedzi (AT URI na Bluesky). Nieudany wątek nie cofa publikacji posta. threadReplies i threadReplyMediaUrls są puste, a pozostałe pola mają wartość null, gdy platforma nie ma wątku |
tiktokDraftFallback | Tylko TikTok. true, gdy osiągnięto dzienny limit bezpośredniej publikacji na TikToku i treść trafiła do skrzynki TikToka jako wersja robocza |
instagramTrialGraduation | Tylko Instagram. MANUAL lub SS_PERFORMANCE, gdy Reel jest publikowany jako próbny. Zob. Konfiguracje platform |
instagramCollaborators | Tylko Instagram. Nazwy użytkowników zaproszonych do współpracy. Zob. Konfiguracje platform |
instagramUserTags | Tylko Instagram. Konta oznaczone w multimediach, każde z username, x i y. Zob. Konfiguracje platform |
instagramUntaggedUsernames | Tylko Instagram. Oznaczone konta odrzucone przez Instagram, ponieważ są prywatne lub nie istnieją. Post opublikowano bez ich oznaczeń |
instagramUsername | Tylko Instagram. Nazwa konta na Instagramie, z którego opublikowano wpis, ustawiana po publikacji |
instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolume | Tylko Instagram. Dźwięk dodany do Reela przez instagramConfigs[].audio, z tytułem, wykonawcą i obiema głośnościami |
facebookTextFormatPresetId | Tylko Facebook. Tło tekstu wysłane z postem. Zob. Konfiguracje platform |
facebookImageLayout | Tylko Facebook. GRID lub CAROUSEL, jeśli ustawiono. Zob. Konfiguracje platform |
facebookCarouselCards | Tylko Facebook. Karty karuzeli, po jednej na obraz, każda z linkiem, tytułem i opisem. Zob. Konfiguracje platform |
linkedinDocumentTitle | Tylko LinkedIn. Tytuł posta DOCUMENT, jeśli ustawiono |
linkedinReshareOf | Tylko LinkedIn. URN udostępnianego posta (urn:li:share:... lub urn:li:ugcPost:...), jeśli jest to ponowne udostępnienie |
twitterKeepLinks | Tylko X. true, gdy zażądano zachowania klikalnych linków w tekście na X. Respektowane tylko dla ofert dożywotnich AppSumo |
twitterQuoteOf | Tylko X. ID cytowanego posta, jeśli jest to cytat |
googleBusiness* | Tylko Google Business Profile. Typ posta, przycisk oraz ustawienia wydarzenia i oferty z googleBusinessConfigs, np. googleBusinessTopicType, googleBusinessCallToActionType lub googleBusinessEventStart. Zob. Konfiguracje platform |
wordpressTitle, wordpressExcerpt, wordpressCategoryIds, wordpressTags, wordpressStatus | Tylko WordPress. Tytuł, zajawka, id kategorii i tagi wysłane z postem. Zob. Konfiguracje platform. wordpressStatus to PUBLISH, DRAFT lub PENDING. |
tumblrTags, tumblrTitle, tumblrSourceUrl | Tylko Tumblr. Tagi, tytuł i link do źródła wysłane z postem. Zob. Konfiguracje platform |
youtubeDefaultAudioLanguage | Tylko YouTube. Język oryginalnej ścieżki dźwiękowej filmu, jeśli ustawiono. Zob. Konfiguracje platform |
youtubeScheduleOnYouTube, youtubeScheduledVideoId | Tylko YouTube. youtubeScheduleOnYouTube ma wartość true, gdy post ma zostać zaplanowany na YouTube. youtubeScheduledVideoId to film przesłany przed scheduledAt; dopóki jest ustawiony, a wpis nie został opublikowany, posta nie można zaktualizować ani cofnąć jego zaplanowania. Zob. Konfiguracje platform |
instagramAiGenerated, facebookAiGenerated, youtubeAiGenerated | true, gdy post ma oznaczenie AI platformy: etykietę informacji o AI na Instagramie i Facebooku lub etykietę treści zmienionych albo syntetycznych na YouTube. Zob. Konfiguracje platform |
pinterest*, tiktok*, instagram*, facebook*, youtube* | Konfiguracja platformy użyta przy tworzeniu wpisu, np. pinterestBoardId, tiktokPrivacyLevel, instagramPostType, facebookPostType lub youtubePrivacyStatus. Zob. Konfiguracje platform |
Podglądy multimediów
Każda platforma ma tablicę previewUrls z hostowanymi przez nas podglądami (WebP, do 720 px, dla filmów nieruchoma klatka). Jest wypełniana krótko po rozpoczęciu publikacji i zwykle zawiera po jednym wpisie na element, a pusty ciąg oznacza, że elementu nie udało się wyrenderować. Post, którego multimedia już wygasły, otrzymuje jeden obraz okładki. Po publikacji mediaUrls może zostać zastąpione linkami CDN platformy, które wygasają w ciągu kilku dni, a przesłane pliki źródłowe są usuwane. Do późniejszego wyświetlania należy używać previewUrls.
Posty cykliczne
Post utworzony przez serię cykliczną ma dwa dodatkowe pola. recurringPostId to jego seria. occurrenceAt to termin serii, który wypełnia; nie zmienia się po przełożeniu posta. Pozostałe posty nie mają tych pól. Usunięcie jednego posta serii pomija ten termin, a seria trwa dalej.
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"
}