Listings APIListings API
Iniciar sesión
GET/api/v4/social/posts/{postId}

Obtener una publicación en redes sociales

Devuelve una publicación en redes sociales con su contenido, su programación y el estado de publicación, el enlace y el error actualizados de cada canal.

Requiere una clave de API. Consulta Autenticación para conocer el formato del encabezado y la rotación de claves.

Parámetros

Ruta

NombreTipoObligatorioDescripción
postIdstringobligatorioPost UUID, the `socialPostId` returned by POST /social/posts or the `socialPostId` of a row from the brand's post list.

Respuestas

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.

Obtiene una publicación por su UUID, con el contenido redactado, la programación resultante y una entrada por cada canal de destino que describe lo que ocurrió realmente en esa plataforma. Este es el endpoint que consultas periódicamente después de crear una publicación.

Caso de uso: verificación posterior a la publicación. La publicación es asíncrona, por lo que POST /social/posts solo te indica que se aceptó la publicación. Consulta periódicamente este endpoint con el socialPostId devuelto y lee connectedChannels[]: status: "SUCCESS" con un liveLink significa que la publicación ya está disponible en ese canal; status: "ERROR" con error establecido significa que no lo está e indica el motivo. Deja de consultar cuando ningún canal siga en SCHEDULED.

Caso de uso: mostrar al cliente dónde se publicó su contenido. Muestra cada connectedChannels[].liveLink como un enlace externo para que el usuario pueda abrir la publicación en la propia plataforma, y muestra error junto a los canales que fallaron en lugar de reducir toda la publicación a un único estado de error.

Interpretación de los campos de estado

Hay dos niveles de estado y responden a preguntas diferentes.

CampoValoresSignificado
statusDRAFT, PENDING, SCHEDULED, PUBLISHED, FAILED, ARCHIVED, REJECTEDLa publicación en su conjunto.
connectedChannels[].statusSCHEDULED, SUCCESS, ERROR, ARCHIVEDLo que ocurrió en esa plataforma concreta.

Una publicación puede mostrar PUBLISHED como estado general mientras un canal permanece en ERROR. Muestra siempre el estado a partir de connectedChannels[]; el status de la publicación es un resumen.

Notas.

  • globalPostSchedule es el instante de publicación resultante en UTC. Si programaste con scheduleDate + scheduleTime, este es el instante al que se convirtieron esos valores según la zona horaria de la marca, lo que te permite comprobar que la zona era la que esperabas.
  • error es un mensaje legible que puedes mostrar al cliente de forma segura; reason es la etiqueta interna más breve que le corresponde. Ninguno contiene tokens de la plataforma ni identificadores de seguimiento.
  • connectedChannels[].id es el UUID de la conexión que aparece en las conexiones de la marca y el valor que insights requiere como socialConnectedChannelId.
  • Un canal que muestra archived: true se desconectó después de que se creara la publicación. No publicará; consulta desconexión.
  • Un canal que permanece en ERROR tras caducar la autorización necesita un nuevo enlace de conexión, no un reintento de la publicación.
  • Para obtener cifras de interacción en lugar del estado de entrega, llama a GET /social/posts/{postId}/insights.
  • Para listar las publicaciones de una marca en lugar de obtener una sola, usa 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