REST APIGET

Obter Publicação

Recupere uma publicação por ID com o status completo por plataforma, mídia e detalhes de agendamento pela API REST.

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

Retorna os detalhes completos de uma publicação específica, incluindo o status por plataforma, URLs publicados e mensagens de erro caso alguma plataforma tenha falhado.

Chave API (Bearer token)

Permissão:posts.readPapéis e permissões

Status da Plataforma

Cada plataforma no array platforms tem seu próprio status. O status de nível superior de uma publicação reflete o agregado: será POSTED se pelo menos uma plataforma teve sucesso, e FAILED apenas se todas as plataformas falharam.

Campos da resposta

Campo	Descrição
`id`	ID da publicação
`userId`	O membro que criou a publicação
`status`	DRAFT, SCHEDULED, PENDING, PUBLISHING, COMPLETED, PARTIAL_FAILURE ou FAILED
`contentType`	TEXT, IMAGE, VIDEO, CAROUSEL ou DOCUMENT
`text`	O texto padrão para todas as plataformas
`scheduledAt, timezone`	Quando a publicação deve sair (ISO 8601) e o fuso horário IANA enviado com ela. scheduledAt não aparece quando a publicação não tem hora
`mediaUrls, mediaAltTexts`	As mídias como enviadas e o texto alternativo de cada imagem, na mesma ordem. Compartilhados por todas as entradas de plataforma
`thumbnailUrl, thumbnailTimestampMs`	A URL da miniatura do vídeo, ou o quadro escolhido como miniatura em milissegundos, quando enviado
`recurringPostId, occurrenceAt`	Presentes apenas numa publicação criada por uma série recorrente. Veja a seção sobre publicações recorrentes abaixo
`platforms`	Uma entrada por conta para a qual a publicação vai, com os campos abaixo. Um story adicionado com shareToStory é uma entrada própria, com instagramPostType ou facebookPostType STORY
`createdAt, updatedAt`	Quando a publicação foi criada e alterada pela última vez

Campos de cada entrada de plataforma

Campo	Descrição
`id`	ID da entrada de plataforma. POST /api/v1/social-posts/:id/retry aceita esse valor em platformIds
`platform`	FACEBOOK, INSTAGRAM, THREADS, TIKTOK, TWITTER, BLUESKY, MASTODON, LINKEDIN, PINTEREST, YOUTUBE, GOOGLE_BUSINESS, TUMBLR ou TELEGRAM
`status`	PENDING, PUBLISHING, PUBLISHED ou FAILED
`connectionId`	O id da conta de /social-accounts
`pageId, facebookPageExternalId`	Apenas FACEBOOK. O id da página do Facebook, o mesmo valor de pageId em /social-accounts
`accountName`	Nome da conta conectada
`text`	O texto enviado a esta plataforma, depois de aplicar platformTexts
`platformPostId`	O ID da publicação na plataforma, depois de publicada
`postUrl`	Link público para a publicação, preenchido assim que a plataforma a publica, em todas as plataformas. Stories do Instagram e do Facebook expiram em 24 horas, então para eles o link leva ao perfil ou à página que os publicou
`errorMessage`	Por que esta plataforma falhou
`publishedAt`	Quando esta plataforma publicou a publicação
`mediaUrls, mediaAltTexts, previewUrls`	As mídias e o texto alternativo enviados a esta plataforma, e as pré-visualizações que hospedamos. Veja a seção sobre pré-visualizações de mídia abaixo
`thumbnailUrl, thumbnailTimestampMs`	A imagem ou o quadro definido para esta plataforma com platformThumbnails. Ausente quando a plataforma usa a miniatura da publicação
`mediaAspectRatio, mediaAspectRatioFit`	O formato definido para esta plataforma com platformAspectRatios (SQUARE, PORTRAIT, VERTICAL ou LANDSCAPE) e como ele foi obtido (CROP ou PAD). Ausente quando as imagens saíram como foram enviadas
`firstComment, firstCommentStatus, firstCommentId, firstCommentError, firstCommentPublishedAt`	O primeiro comentário definido para esta plataforma e como ele saiu. firstCommentStatus é PENDING até o comentário sair, depois PUBLISHED com firstCommentId e firstCommentPublishedAt, ou FAILED com firstCommentError. Um comentário com falha deixa a publicação publicada. Tudo null quando a plataforma não tem primeiro comentário
`threadReplies, threadStatus, threadReplyIds, threadError, threadPublishedAt`	O fio definido para esta plataforma e até onde chegou. threadStatus é PENDING até sair cada resposta, depois PUBLISHED com threadPublishedAt, ou FAILED com threadError. threadReplyIds lista os ids das respostas publicadas até agora (AT URIs no Bluesky). Um fio que falha deixa a publicação publicada. threadReplies fica vazio e o resto null quando a plataforma não tem fio
`tiktokDraftFallback`	Apenas TikTok. true quando o limite diário de publicação direta do TikTok foi atingido e o conteúdo foi enviado para os rascunhos do TikTok
`instagramTrialGraduation`	Apenas Instagram. MANUAL ou SS_PERFORMANCE quando o reel é publicado como reel de teste. Consulte Configurações de Plataforma
`instagramCollaborators`	Só Instagram. Os nomes de usuário convidados como colaboradores. Veja Configurações de plataforma
`instagramUserTags`	Somente Instagram. As contas marcadas na mídia, cada uma com username, x e y. Veja Configurações de plataforma
`instagramUntaggedUsernames`	Somente Instagram. Contas marcadas que o Instagram recusou por serem privadas ou não existirem. A publicação saiu sem marcações
`instagramUsername`	Só Instagram. O usuário do Instagram pelo qual a entrada foi publicada, preenchido depois da publicação
`instagramAudioId, instagramAudioTitle, instagramAudioArtist, instagramAudioVolume, instagramVideoVolume`	Só Instagram. O áudio adicionado ao Reel com instagramConfigs[].audio, com título, artista e os dois volumes
`facebookTextFormatPresetId`	Só Facebook. O fundo de texto enviado com a publicação. Veja Configurações de plataforma
`facebookImageLayout`	Só Facebook. GRID ou CAROUSEL, quando definido. Veja Configurações de plataforma
`facebookCarouselCards`	Só Facebook. Os cartões do carrossel, um por imagem, cada um com link, title e description. Veja Configurações de plataforma
`linkedinDocumentTitle`	Apenas LinkedIn. O título de uma publicação DOCUMENT, quando definido
`linkedinReshareOf`	Apenas LinkedIn. O URN da publicação que esta compartilha (urn:li:share:... ou urn:li:ugcPost:...), quando é um compartilhamento
`twitterKeepLinks`	Só X. true quando os links do texto do X devem continuar clicáveis. Só vale para lifetime deals da AppSumo
`googleBusiness*`	Só Perfil da Empresa no Google. O tipo de publicação, o botão e as configurações de evento e oferta de googleBusinessConfigs, por exemplo googleBusinessTopicType, googleBusinessCallToActionType ou googleBusinessEventStart. Veja Configurações de plataforma
`pinterest, tiktok, instagram, facebook, youtube*`	A configuração de plataforma com que a entrada foi criada, por exemplo pinterestBoardId, tiktokPrivacyLevel, instagramPostType, facebookPostType ou youtubePrivacyStatus. Consulte Configurações de Plataforma

Pré-visualizações de mídia

Cada plataforma tem um array previewUrls com imagens de pré-visualização hospedadas por nós (WebP, até 720 px, um quadro estático para vídeos). Ele é preenchido logo após o início da publicação e normalmente tem uma entrada por item de mídia, onde uma string vazia significa que o item não pôde ser renderizado. Uma publicação cuja mídia já tinha expirado recebe uma única imagem de capa no lugar. Após a publicação, mediaUrls pode ser substituído pelos links de CDN da plataforma, que expiram em poucos dias, e os arquivos de origem enviados são removidos. Use previewUrls para tudo o que você exibir depois.

Publicações recorrentes

Uma publicação criada por uma série recorrente tem dois campos a mais. recurringPostId é a série a que ela pertence. occurrenceAt é a data da série que ela ocupa e não muda quando você reagenda a publicação. As outras publicações não têm esses campos. Excluir uma publicação de uma série pula essa data, e a série continua.

Obter uma publicação social

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