REST APIGET

Obtenir un post

Récupérez une publication par ID avec le statut complet par plateforme, les médias et les détails de planification.

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

Renvoie les details complets d'une publication specifique, y compris le statut par plateforme, les URL publiees et les messages d'erreur si une plateforme a echoue.

Cle API (jeton Bearer)

Permission:posts.readRôles et permissions

Statut par plateforme

Chaque plateforme dans le tableau platforms possede son propre statut. Le statut global d'une publication reflete l'ensemble : il sera POSTED si au moins une plateforme a reussi, et FAILED uniquement si toutes les plateformes ont echoue.

Champs de la réponse

Champ	Description
`id`	ID de la publication
`userId`	Le membre qui a créé la publication
`status`	DRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE ou FAILED
`contentType`	TEXT, IMAGE, VIDEO, CAROUSEL ou DOCUMENT
`text`	Le texte par défaut pour toutes les plateformes
`scheduledAt, timezone`	Quand la publication doit partir (ISO 8601), et le fuseau horaire IANA envoyé avec elle. scheduledAt est absent si la publication n'a pas d'heure
`mediaUrls, mediaAltTexts`	Les médias tels qu'envoyés et leur texte alternatif par image, dans le même ordre. Partagés par toutes les entrées de plateforme
`thumbnailUrl, thumbnailTimestampMs`	L'URL de la miniature de la vidéo, ou l'image choisie comme miniature en millisecondes, si elle a été envoyée
`recurringPostId, occurrenceAt`	Présents seulement sur une publication créée par une série récurrente. Voir la section sur les publications récurrentes plus bas
`platforms`	Une entrée par compte visé par la publication, avec les champs ci-dessous. Une story ajoutée avec shareToStory est une entrée à part, avec instagramPostType ou facebookPostType STORY
`createdAt, updatedAt`	Quand la publication a été créée et modifiée pour la dernière fois

Champs d'une entrée de plateforme

Champ	Description
`id`	ID de l'entrée de plateforme. POST /api/v1/social-posts/:id/retry l'accepte dans platformIds
`platform`	FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST, YOUTUBE, GOOGLE_BUSINESS ou TELEGRAM. TELEGRAM n'apparaît que sur les publications créées dans l'app
`status`	PENDING, PUBLISHING, PUBLISHED ou FAILED
`connectionId`	L'id du compte de /social-accounts
`pageId, facebookPageExternalId`	FACEBOOK uniquement. L'id de la page Facebook, la même valeur que pageId dans /social-accounts
`accountName`	Nom du compte connecté
`text`	Le texte envoyé à cette plateforme, après application de platformTexts
`platformPostId`	L'ID de la publication sur la plateforme, une fois publiée
`postUrl`	Lien public vers la publication, renseigné dès que la plateforme l'a publiée, sur toutes les plateformes. Les stories Instagram et Facebook expirent au bout de 24 heures, il renvoie donc pour elles vers le profil ou la page qui les a publiées
`errorMessage`	Pourquoi cette plateforme a échoué
`publishedAt`	Quand cette plateforme a publié la publication
`mediaUrls, mediaAltTexts, previewUrls`	Les médias et le texte alternatif envoyés à cette plateforme, et les aperçus que nous hébergeons. Voir la section sur les aperçus des médias plus bas
`thumbnailUrl, thumbnailTimestampMs`	L'image ou l'image de la vidéo définie pour cette plateforme via platformThumbnails. Absente quand la plateforme utilise la miniature de la publication
`mediaAspectRatio, mediaAspectRatioFit`	Le format défini pour cette plateforme via platformAspectRatios (SQUARE, PORTRAIT, VERTICAL ou LANDSCAPE) et la façon de l’obtenir (CROP ou PAD). Absent quand les images sont parties telles qu’envoyées
`firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt`	Le premier commentaire défini pour cette plateforme et son résultat. firstCommentStatus vaut PENDING jusqu'à l'envoi du commentaire, puis PUBLISHED avec firstCommentId et firstCommentPublishedAt, ou FAILED avec firstCommentError. Un commentaire en échec laisse la publication publiée. Tout est null quand la plateforme n'a pas de premier commentaire
`tiktokDraftFallback`	TikTok uniquement. true lorsque la limite quotidienne de publication directe TikTok a été atteinte et que le contenu a été envoyé dans les brouillons TikTok
`instagramTrialGraduation`	Instagram uniquement. MANUAL ou SS_PERFORMANCE lorsque le reel est publié comme reel d'essai. Consultez Configurations des plateformes
`instagramCollaborators`	Instagram uniquement. Les noms d’utilisateur invités comme collaborateurs. Consultez Configurations des plateformes
`instagramUsername`	Instagram uniquement. Le compte Instagram depuis lequel l’entrée a été publiée, renseigné une fois publiée
`instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolume`	Instagram uniquement. L’audio ajouté au Reel via instagramConfigs[].audio, avec son titre, son artiste et les deux volumes
`facebookTextFormatPresetId`	Facebook uniquement. Le fond de texte envoyé avec la publication. Consultez Configurations des plateformes
`linkedinDocumentTitle`	LinkedIn uniquement. Le titre d'une publication DOCUMENT, s'il a été défini
`twitterKeepLinks`	X uniquement. true quand les liens du texte X doivent rester cliquables. Pris en compte seulement pour les offres AppSumo à vie
`googleBusiness*`	Fiche d’établissement Google uniquement. Le type de publication, le bouton et les réglages d’événement et d’offre de googleBusinessConfigs, par exemple googleBusinessTopicType, googleBusinessCallToActionType ou googleBusinessEventStart. Consultez Configurations des plateformes
`pinterest, tiktok, instagram, facebook, youtube*`	La configuration de plateforme avec laquelle l'entrée a été créée, par exemple pinterestBoardId, tiktokPrivacyLevel, instagramPostType, facebookPostType ou youtubePrivacyStatus. Consultez Configurations des plateformes

Aperçus des médias

Chaque plateforme possède un tableau previewUrls contenant des images d'aperçu que nous hébergeons (WebP, 720 px maximum, une image fixe pour les vidéos). Il est rempli peu après le début de la publication et contient normalement une entrée par média, une chaîne vide signifiant que l'élément n'a pas pu être rendu. Une publication dont les médias avaient déjà expiré reçoit à la place une seule image de couverture. Après la publication, mediaUrls peut être remplacé par les liens CDN de la plateforme, qui expirent en quelques jours, et les fichiers sources téléversés sont supprimés. Utilisez previewUrls pour tout ce que vous affichez plus tard.

Publications récurrentes

Une publication créée par une série récurrente a deux champs de plus. recurringPostId est la série dont elle fait partie. occurrenceAt est la date de la série qu'elle occupe, et ne change pas si vous reprogrammez la publication. Les autres publications n'ont pas ces champs. Supprimer une publication d'une série saute cette date, et la série continue.

Obtenir une publication sociale

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