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 publicacao especifica, incluindo o estado 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

Estado da Plataforma

Cada plataforma no array platforms tem o seu proprio estado. O estado de nivel superior de uma publicacao reflete o agregado, sera 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 ou TELEGRAM. TELEGRAM só aparece em publicações criadas no app
`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
`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 Configuracoes de Plataforma
`instagramCollaborators`	Só Instagram. Os nomes de usuário convidados como colaboradores. Veja Configurações de plataforma
`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
`linkedinDocumentTitle`	Apenas LinkedIn. O título de uma publicação DOCUMENT, quando definido
`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 Configuracoes 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 ficheiros 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 publicacao 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"
}