REST APIGET

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.

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

Zwraca 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.

Klucz API (token Bearer)
Uprawnienie:posts.readRole i uprawnienia

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

PoleOpis
idID posta
userIdCzłonek, który utworzył post
statusDRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE lub FAILED
contentTypeTEXT, IMAGE, VIDEO, CAROUSEL lub DOCUMENT
textDomyślny tekst dla wszystkich platform
scheduledAt, timezoneTermin publikacji posta (ISO 8601) i wysłana z nim strefa czasowa IANA. scheduledAt jest pomijane, gdy post nie ma terminu
mediaUrls, mediaAltTextsPrzesł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, thumbnailTimestampMsAdres URL miniatury filmu lub klatka wybrana jako miniatura, w milisekundach, jeśli ją wysłano
recurringPostId, occurrenceAtUstawiane tylko dla posta utworzonego przez serię cykliczną. Zob. sekcję o postach cyklicznych poniżej
platformsJeden 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, updatedAtData utworzenia i ostatniej zmiany posta

Pola wpisu platformy

PoleOpis
idID wpisu platformy. POST /api/v1/social-posts/:id/retry przyjmuje je w platformIds
platformFACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST, YOUTUBE, GOOGLE_BUSINESS, TUMBLR, WORDPRESS lub TELEGRAM
statusPENDING, PUBLISHING, PUBLISHED lub FAILED
connectionIdId konta z /social-accounts
pageId, facebookPageExternalIdTylko FACEBOOK. Id strony na Facebooku, ta sama wartość co pageId w /social-accounts
accountNameNazwa połączonego konta
textTekst wysłany na tę platformę, po zastosowaniu platformTexts
platformPostIdID posta na platformie, po publikacji
postUrlPubliczny 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
errorMessagePrzyczyna niepowodzenia na tej platformie
publishedAtMoment publikacji posta na tej platformie
mediaUrls, mediaAltTexts, previewUrlsMultimedia i tekst alternatywny wysłane na tę platformę oraz hostowane przez nas podglądy. Zob. sekcję o podglądach multimediów poniżej
mediaOverrideUrls, mediaOverrideAltTextsMultimedia 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, thumbnailTimestampMsObraz lub klatka miniatury ustawione dla tej platformy przez platformThumbnails. Brak, gdy platforma używa miniatury posta
mediaAspectRatio, mediaAspectRatioFitKształ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, firstCommentDueAtPierwszy 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, threadPublishedAtWą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
tiktokDraftFallbackTylko TikTok. true, gdy osiągnięto dzienny limit bezpośredniej publikacji na TikToku i treść trafiła do skrzynki TikToka jako wersja robocza
instagramTrialGraduationTylko Instagram. MANUAL lub SS_PERFORMANCE, gdy Reel jest publikowany jako próbny. Zob. Konfiguracje platform
instagramCollaboratorsTylko Instagram. Nazwy użytkowników zaproszonych do współpracy. Zob. Konfiguracje platform
instagramUserTagsTylko Instagram. Konta oznaczone w multimediach, każde z username, x i y. Zob. Konfiguracje platform
instagramUntaggedUsernamesTylko Instagram. Oznaczone konta odrzucone przez Instagram, ponieważ są prywatne lub nie istnieją. Post opublikowano bez ich oznaczeń
instagramUsernameTylko Instagram. Nazwa konta na Instagramie, z którego opublikowano wpis, ustawiana po publikacji
instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolumeTylko Instagram. Dźwięk dodany do Reela przez instagramConfigs[].audio, z tytułem, wykonawcą i obiema głośnościami
facebookTextFormatPresetIdTylko Facebook. Tło tekstu wysłane z postem. Zob. Konfiguracje platform
facebookImageLayoutTylko Facebook. GRID lub CAROUSEL, jeśli ustawiono. Zob. Konfiguracje platform
facebookCarouselCardsTylko Facebook. Karty karuzeli, po jednej na obraz, każda z linkiem, tytułem i opisem. Zob. Konfiguracje platform
linkedinDocumentTitleTylko LinkedIn. Tytuł posta DOCUMENT, jeśli ustawiono
linkedinReshareOfTylko LinkedIn. URN udostępnianego posta (urn:li:share:... lub urn:li:ugcPost:...), jeśli jest to ponowne udostępnienie
twitterKeepLinksTylko X. true, gdy zażądano zachowania klikalnych linków w tekście na X. Respektowane tylko dla ofert dożywotnich AppSumo
twitterQuoteOfTylko 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, wordpressStatusTylko WordPress. Tytuł, zajawka, id kategorii i tagi wysłane z postem. Zob. Konfiguracje platform. wordpressStatus to PUBLISH, DRAFT lub PENDING.
tumblrTags, tumblrTitle, tumblrSourceUrlTylko Tumblr. Tagi, tytuł i link do źródła wysłane z postem. Zob. Konfiguracje platform
youtubeDefaultAudioLanguageTylko YouTube. Język oryginalnej ścieżki dźwiękowej filmu, jeśli ustawiono. Zob. Konfiguracje platform
youtubeScheduleOnYouTube, youtubeScheduledVideoIdTylko 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, youtubeAiGeneratedtrue, 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.

Pobranie posta
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"
}