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
`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 oder YOUTUBE
`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 platformPostId bekannt ist, für jede Plattform außer MASTODON
`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
`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
`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
`linkedinDocumentTitle`	Nur LinkedIn. Der Titel eines DOCUMENT-Beitrags, falls einer gesetzt wurde
`twitterKeepLinks`	Nur X. true, wenn Links im X-Text klickbar bleiben sollen. Gilt nur für AppSumo-Lifetime-Deals
`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"
}