REST APIGET

Beitrag abrufen

Rufen Sie einen einzelnen Beitrag nach ID mit vollständigem Plattformstatus, Medien und Planungsdetails über die API ab.

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

Gibt die vollständigen Details eines bestimmten Beitrags zurück, einschließlich plattformspezifischem Status, veröffentlichten URLs und Fehlermeldungen, falls eine Plattform fehlgeschlagen ist.

API-Schlüssel (Bearer-Token)

Berechtigung:posts.readRollen und Berechtigungen

Plattformstatus

Jede Plattform im platforms-Array hat ihren eigenen Status. Der übergeordnete Status eines Beitrags spiegelt den Gesamtstatus wider, er ist POSTED, wenn mindestens eine Plattform erfolgreich war, und FAILED nur, wenn alle Plattformen fehlgeschlagen sind.

Antwortfelder

Feld	Beschreibung
`id`	Beitrags-ID
`userId`	Das Mitglied, das den Beitrag erstellt hat
`status`	DRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE oder FAILED
`contentType`	TEXT, IMAGE, VIDEO, CAROUSEL oder DOCUMENT
`text`	Der Standardtext für alle Plattformen
`scheduledAt, timezone`	Wann der Beitrag erscheinen soll (ISO 8601), und die mitgesendete IANA-Zeitzone. scheduledAt fehlt, wenn der Beitrag keinen Termin hat
`mediaUrls, mediaAltTexts`	Die Medien wie eingereicht und ihr Alternativtext pro Bild, in derselben Reihenfolge. Gilt für alle Plattformeinträge
`thumbnailUrl, thumbnailTimestampMs`	Die URL des Video-Vorschaubilds oder das als Vorschaubild gewählte Bild in Millisekunden, falls gesendet
`recurringPostId, occurrenceAt`	Nur bei einem Beitrag aus einer wiederkehrenden Serie gesetzt. Siehe den Abschnitt zu wiederkehrenden Beiträgen unten
`platforms`	Ein Eintrag pro Konto, an das der Beitrag geht, mit den Feldern unten. Eine mit shareToStory ergänzte Story ist ein eigener Eintrag mit instagramPostType oder facebookPostType STORY
`createdAt, updatedAt`	Wann der Beitrag erstellt und zuletzt geändert wurde

Felder eines Plattformeintrags

Feld	Beschreibung
`id`	ID des Plattformeintrags. POST /api/v1/social-posts/:id/retry akzeptiert sie in platformIds
`platform`	FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST, YOUTUBE, GOOGLE_BUSINESS, TUMBLR oder TELEGRAM
`status`	PENDING, PUBLISHING, PUBLISHED oder FAILED
`connectionId`	Die Konto-id aus /social-accounts
`pageId, facebookPageExternalId`	Nur FACEBOOK. Die Facebook-Seiten-ID, derselbe Wert wie pageId in /social-accounts
`accountName`	Name des verbundenen Kontos
`text`	Der an diese Plattform gesendete Text, nach Anwendung von platformTexts
`platformPostId`	Die ID des Beitrags auf der Plattform, sobald er veröffentlicht ist
`postUrl`	Öffentlicher Link zum veröffentlichten Beitrag, gesetzt, sobald die Plattform ihn veröffentlicht hat, auf jeder Plattform. Instagram- und Facebook-Storys laufen nach 24 Stunden ab, deshalb verweist er bei ihnen auf das Profil oder die Seite, die sie gepostet hat
`errorMessage`	Warum diese Plattform fehlgeschlagen ist
`publishedAt`	Wann diese Plattform den Beitrag veröffentlicht hat
`mediaUrls, mediaAltTexts, previewUrls`	Die an diese Plattform gesendeten Medien und Alternativtexte sowie die von uns gehosteten Vorschauen. Siehe den Abschnitt zu Medienvorschauen unten
`thumbnailUrl, thumbnailTimestampMs`	Das für diese Plattform über platformThumbnails gesetzte Bild oder Videobild. Fehlt, wenn die Plattform das Thumbnail des Beitrags nutzt
`mediaAspectRatio, mediaAspectRatioFit`	Das über platformAspectRatios gesetzte Format für diese Plattform (SQUARE, PORTRAIT, VERTICAL oder LANDSCAPE) und wie es erreicht wurde (CROP oder PAD). Fehlt, wenn die Bilder wie hochgeladen gesendet wurden
`firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt`	Der für diese Plattform gesetzte erste Kommentar und sein Ergebnis. firstCommentStatus ist PENDING, bis der Kommentar rausgeht, danach PUBLISHED mit firstCommentId und firstCommentPublishedAt oder FAILED mit firstCommentError. Ein fehlgeschlagener Kommentar lässt den Beitrag veröffentlicht. Alles null, wenn die Plattform keinen ersten Kommentar hat
`threadReplies, threadStatus, threadReplyIds, threadError, threadPublishedAt`	Der für diese Plattform gesetzte Thread und wie weit er kam. threadStatus ist PENDING, bis jede Antwort rausgeht, danach PUBLISHED mit threadPublishedAt oder FAILED mit threadError. threadReplyIds listet die IDs der bisher geposteten Antworten (AT-URIs bei Bluesky). Ein fehlgeschlagener Thread lässt den Beitrag veröffentlicht. threadReplies ist leer und der Rest null, wenn die Plattform keinen Thread hat
`tiktokDraftFallback`	Nur TikTok. true, wenn das tägliche TikTok-Limit für direktes Posten erreicht war und der Inhalt stattdessen als Entwurf im TikTok-Posteingang gelandet ist
`instagramTrialGraduation`	Nur Instagram. MANUAL oder SS_PERFORMANCE, wenn das Reel als Test-Reel veröffentlicht wird. Siehe Plattform-Konfigurationen
`instagramCollaborators`	Nur Instagram. Die als Mitwirkende eingeladenen Nutzernamen. Siehe Plattform-Konfigurationen
`instagramUserTags`	Nur Instagram. Die im Medium markierten Konten, jeweils mit username, x und y. Siehe Plattform-Konfigurationen
`instagramUntaggedUsernames`	Nur Instagram. Markierte Konten, die Instagram abgelehnt hat, weil sie privat sind oder nicht existieren. Der Beitrag wurde ohne Markierungen veröffentlicht
`instagramUsername`	Nur Instagram. Das Instagram-Handle, von dem der Eintrag veröffentlicht wurde, gesetzt nach der Veröffentlichung
`instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolume`	Nur Instagram. Das über instagramConfigs[].audio zum Reel hinzugefügte Audio mit Titel, Interpret und beiden Lautstärken
`facebookTextFormatPresetId`	Nur Facebook. Der mit dem Beitrag gesendete Texthintergrund. Siehe Plattform-Konfigurationen
`facebookImageLayout`	Nur Facebook. GRID oder CAROUSEL, wenn gesetzt. Siehe Plattform-Konfigurationen
`facebookCarouselCards`	Nur Facebook. Die Karussellkarten, eine pro Bild, jeweils mit link, title und description. Siehe Plattform-Konfigurationen
`linkedinDocumentTitle`	Nur LinkedIn. Der Titel eines DOCUMENT-Beitrags, falls einer gesetzt wurde
`linkedinReshareOf`	Nur LinkedIn. Die URN des Beitrags, den dieser Beitrag weiterteilt (urn:li:share:... oder urn:li:ugcPost:...), falls er weitergeteilt wird
`twitterKeepLinks`	Nur X. true, wenn Links im X-Text klickbar bleiben sollen. Gilt nur für AppSumo-Lifetime-Deals
`googleBusiness*`	Nur Google Unternehmensprofil. Beitragstyp, Button, Event- und Angebotseinstellungen aus googleBusinessConfigs, zum Beispiel googleBusinessTopicType, googleBusinessCallToActionType oder googleBusinessEventStart. Siehe Plattform-Konfigurationen
`pinterest, tiktok, instagram, facebook, youtube*`	Die Plattform-Konfiguration, mit der der Eintrag erstellt wurde, zum Beispiel pinterestBoardId, tiktokPrivacyLevel, instagramPostType, facebookPostType oder youtubePrivacyStatus. Siehe Plattform-Konfigurationen

Medienvorschauen

Jede Plattform hat ein previewUrls-Array mit Vorschaubildern, die wir hosten (WebP, bis zu 720 px, bei Videos ein Standbild). Es wird kurz nach Beginn der Veröffentlichung gefüllt und enthält normalerweise einen Eintrag pro Medienelement, wobei ein leerer String bedeutet, dass das Element nicht gerendert werden konnte. Ein Beitrag, dessen Medien bereits abgelaufen waren, erhält stattdessen ein einzelnes Titelbild. Nach der Veröffentlichung kann mediaUrls durch die CDN-Links der Plattform ersetzt werden, die innerhalb weniger Tage ablaufen, und die hochgeladenen Quelldateien werden entfernt. Verwenden Sie previewUrls für alles, was Sie später anzeigen.

Wiederkehrende Beiträge

Ein Beitrag aus einer wiederkehrenden Serie hat zwei zusätzliche Felder. recurringPostId ist die Serie, zu der er gehört. occurrenceAt ist der Termin der Serie, den er belegt, und bleibt gleich, wenn Sie den Beitrag verschieben. Andere Beiträge enthalten beide Felder nicht. Wenn Sie einen Beitrag einer Serie löschen, entfällt dieser Termin und die Serie läuft weiter.

Einen Social-Media-Beitrag abrufen

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