antworkDOCS

Listar publicaciones

Todas tus publicaciones, de la más reciente a la más antigua, filtradas por espacio, cuenta, campaña, estado y fecha, página a página.

GEThttps://antwork.io/api/v1/postsPermisoread

Petición

GET /api/v1/posts es la vía de recuperación: la única otra forma de llegar a una publicación es el id que devolvió la creación. De la más reciente a la más antigua, en todos tus espacios de trabajo. Filtro opcional status (uno de los cuatro de arriba), limit de 1 a 100 (por defecto 25) y cursor con el nextCursor de la página anterior. Un nextCursor nulo significa que no hay más.

curl "https://antwork.io/api/v1/posts?status=scheduled&limit=25" \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Filtros

Cada filtro lo resuelve un índice de la base de datos, así que una página nunca sale corta por haber filtrado algo después de leerlo. Una combinación que ningún índice resuelve se rechaza con invalid_filter en lugar de servirse despacio.

statusstring
Uno de draft, scheduled, published, failed, pending_approval. Se combina con cualquier otro filtro.
workspaceIdstring
Solo las publicaciones de este espacio, ordenadas por scheduledFor, de la más reciente a la más antigua.
accountIdstring
Solo las publicaciones de esta cuenta. Requiere también status: las publicaciones de una cuenta se listan un estado cada vez.
campaignIdstring
Solo las publicaciones que creó juntas una misma llamada. Se combina con cualquier otro filtro.
fromISO 8601
Programadas en este momento ISO 8601 o después. Requiere workspaceId o accountId.
toISO 8601
Programadas en este momento ISO 8601 o antes. Requiere workspaceId o accountId.
updatedSinceISO 8601
Modificadas en este momento ISO 8601 o después: el feed que lee un disparador por sondeo, como status=published&updatedSince=<último sondeo>. Requiere status, solo se combina con workspaceId y se ordena por updatedAt. Una publicación editada vuelve a aparecer, así que deduplica por su id.
attentionboolean
true responde en una sola llamada lo que necesita tu atención en lugar de una página: failed (los últimos tres días, cada una con el advice de la plataforma), pendingApproval, drafts (stale, mediaRequired) y upcoming, limit por grupo (5 por defecto, como mucho 10), con attentionCounts para los totales. La misma vista que list_posts(attention=true) en MCP. Solo admite workspaceId y limit.

Las listas sin filtro y las de campaña se ordenan por createdAt; las de espacio y de cuenta, por scheduledFor, que con from y to da un calendario. Un espacio o una cuenta que no son tuyos responden 404.

curl "https://antwork.io/api/v1/posts?workspaceId=ws_...&from=2026-11-01T00:00:00Z&to=2026-11-30T23:59:59Z" \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Respuesta

200 OK
{
  "object": "list",
  "posts": [ ... ],
  "nextCursor": "MTc5MDA3..."
}

¿Algo no cuadra? Dinos cuál.