antworkDOCS

Consultar una publicación

La llamada de creación devuelve ids; aquí es donde ves qué ha sido de ellos. Consulta en vez de esperar en la petición de creación, que responde mucho antes de que la plataforma conteste.

GEThttps://antwork.io/api/v1/posts/{id}Permisoread

Petición

curl https://antwork.io/api/v1/posts/pQ7x... \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Respuesta

200 OK
{
  "object": "post",
  "id": "pQ7x...",
  "workspaceId": "ws_...",
  "accountId": "acc_linkedin",
  "platform": "linkedin",
  "campaignId": "b3f1...",
  "status": "published",
  "text": "Shipped the API today.",
  "mediaUrls": [],
  "scheduledFor": "2026-10-01T09:00:00.000Z",
  "publishedAt": "2026-10-01T09:00:04.000Z",
  "publishedUrl": "https://www.linkedin.com/feed/update/...",
  "platformPostId": "urn:li:share:...",
  "error": null,
  "createdAt": "2026-09-22T10:00:00.000Z",
  "updatedAt": "2026-10-01T09:00:04.000Z"
}

Una vez ha salido, se rellenan publishedUrl y platformPostId. Si ha fallado, error.message dice qué contestó la plataforma y error.advice qué hacer al respecto.

Una publicación que no existe, es de otra persona o se ha eliminado responde 404 con post_not_found. Necesita el permiso read.

Estados de una publicación

  • draft — guardada, sin programar. No se enviará.
  • scheduled — esperando su hora, o enviándose ahora mismo.
  • published — publicada en la plataforma. publishedUrl y platformPostId están rellenos.
  • failed — no se publicó. error explica por qué.