Listings APIListings API
Entrar
GET/api/v4/social/posts/{postId}

Obter uma publicação em redes sociais

Retorna uma publicação em redes sociais com seu conteúdo, agendamento e o status de publicação, link e erro atuais por canal.

Requer uma chave de API. Consulte Autenticação para ver o formato do cabeçalho e a rotação de chaves.

Parâmetros

Caminho

NomeTipoObrigatórioDescrição
postIdstringobrigatórioPost UUID, the `socialPostId` returned by POST /social/posts or the `socialPostId` of a row from the brand's post list.

Respostas

200The post, with per-channel publish state in `connectedChannels`.
Response
{  "data": {    "getSocialMediaPost": {      "name": "Autumn collection launch",      "status": "PUBLISHED",      "initialContent": "Our autumn collection lands today. Solid oak, hand-finished, made two blocks from the shop. Come see it in person this weekend.",      "initialMedia": ["https://cdn.example.com/social/autumn-collection.jpg"],      "initialVideo": [],      "globalPostSchedule": "2026-10-02T13:30:00Z",      "customDataFlag": false,      "approvalState": null,      "actionOn": null,      "comment": null,      "postAutomationId": null,      "connectedChannels": [        {          "id": "b81d5b3c-4a90-4f6a-9c11-71e0dd2fa4a7",          "platform": "INSTAGRAM",          "socialPlatformId": 2,          "displayName": "Jenny Home",          "userName": "jennyhome",          "userImage": "https://cdn.listingsapi.com/social/channels/b81d5b3c/avatar.jpg",          "status": "SUCCESS",          "liveLink": "https://www.instagram.com/p/CxYz1234abc/",          "reason": null,          "error": null,          "archived": false        },        {          "id": "2d4e6f80-1c33-4b7a-8e05-9a1b2c3d4e5f",          "platform": "FACEBOOK",          "socialPlatformId": 1,          "displayName": "Jenny Home & Co.",          "userName": "jennyhomeco",          "userImage": "https://cdn.listingsapi.com/social/channels/2d4e6f80/avatar.jpg",          "status": "SUCCESS",          "liveLink": "https://www.facebook.com/jennyhomeco/posts/1029384756",          "reason": null,          "error": null,          "archived": false        },        {          "id": "7c5b9a12-8de4-4a31-b0f2-6e3d4c5b8a90",          "platform": "LINKEDIN",          "socialPlatformId": 4,          "displayName": "Jenny Home",          "userName": "jenny-home",          "userImage": null,          "status": "ERROR",          "liveLink": null,          "reason": "Authorization expired",          "error": "The LinkedIn authorization for this channel is no longer valid. Reconnect the channel and post again.",          "archived": false        }      ]    }  }}
401Unauthenticated, missing or invalid API key.
404No post with that ID on this account.

Busca uma publicação pelo UUID, com o conteúdo elaborado, o agendamento resultante e uma entrada por canal de destino que descreve o que de fato aconteceu naquela plataforma. Este é o endpoint que você consulta periodicamente após criar uma publicação.

Caso de uso: verificação após a publicação. A publicação é assíncrona, então POST /social/posts informa apenas que a publicação foi aceita. Consulte este endpoint periodicamente com o socialPostId retornado e leia connectedChannels[]: status: "SUCCESS" com um liveLink significa que a publicação está disponível naquele canal; status: "ERROR" com error definido significa que ela não está disponível e informa o motivo. Pare de consultar quando nenhum canal ainda estiver em SCHEDULED.

Caso de uso: mostrar ao cliente onde sua publicação foi publicada. Exiba cada connectedChannels[].liveLink como um link externo para que o usuário possa abrir a publicação na própria plataforma e mostre error junto aos canais que falharam, em vez de reduzir toda a publicação a um único estado de falha.

Como interpretar os campos de status

Existem dois níveis de status, e eles respondem a perguntas diferentes.

CampoValoresSignificado
statusDRAFT, PENDING, SCHEDULED, PUBLISHED, FAILED, ARCHIVED, REJECTEDA publicação como um todo.
connectedChannels[].statusSCHEDULED, SUCCESS, ERROR, ARCHIVEDO que aconteceu naquela plataforma específica.

Uma publicação pode apresentar PUBLISHED como status geral enquanto um canal permanece em ERROR. Sempre use connectedChannels[] para exibir os status; o status no nível da publicação é um resumo.

Observações.

  • globalPostSchedule é o instante de publicação resultante em UTC. Se você agendou com scheduleDate + scheduleTime, esse é o resultado da conversão desses valores pelo fuso horário da marca — uma verificação útil para confirmar que o fuso era o esperado.
  • error é uma mensagem legível por pessoas que pode ser exibida com segurança a um cliente; reason é o rótulo interno mais curto correspondente. Nenhum dos dois contém tokens de plataforma ou IDs de rastreamento.
  • connectedChannels[].id é o UUID da conexão obtido em conexões da marca e o valor que insights exige como socialConnectedChannelId.
  • Um canal que apresenta archived: true foi desconectado após a criação da publicação. Ele não publicará; consulte desconectar.
  • Um canal que permanece em ERROR após a expiração da autorização precisa de um novo link de conexão, não de uma nova tentativa de publicação.
  • Para obter números de engajamento em vez do estado de entrega, chame GET /social/posts/{postId}/insights.
  • Para listar as publicações de uma marca em vez de buscar uma só, use GET /social/brands/{brandId}/posts.
Request
curl -X GET 'https://listingsapi.com/api/v4/social/posts/<postId>' \  -H "Authorization: API $LISTINGSAPI_KEY"
Run in playground