antworkDOCS

Leer publicaciones de la plataforma

Lo que una cuenta ha publicado en la plataforma, con Antwork o no, con métricas y enlaces.

POSThttps://antwork.io/api/v1/accounts/{id}/platform-posts:fetchPermisoread

Petición

curl -X POST https://antwork.io/api/v1/accounts/acc_x/platform-posts:fetch \
  -H "Authorization: Bearer $ANTWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxPosts": 10
  }'

La misma lectura que la herramienta MCP fetch_platform_posts, para una cuenta. maxPosts va de 1 a 25, 10 por defecto. Requiere el permiso read.

Es un POST porque no es gratis: cada llamada gasta la cuota de API de la cuenta en la plataforma, y X cobra por publicación devuelta. Las lecturas de X se guardan una semana y se sirven desde ahí. Cada clave puede hacer 10 de estas lecturas cada 10 minutos (429 platform_read_rate_limited), además de los límites generales.

Respuesta

200 OK
{
  "object": "platform_posts",
  "accountId": "acc_x",
  "workspaceId": "ws_...",
  "platform": "x",
  "accountName": "Antwork",
  "accountHandle": "@antwork",
  "posts": [
    {
      "id": "1849...",
      "text": "Shipped the API today.",
      "publishedAt": "2026-10-21T09:00:04.000Z",
      "engagementMetrics": { "likes": 52, "comments": 4, "shares": 9, "impressions": 2400 },
      "mediaType": "text",
      "permalink": "https://x.com/antwork/status/1849..."
    }
  ],
  "postCount": 1
}

LinkedIn no deja que un perfil personal liste sus propias publicaciones, así que uno responde 200 con unsupported: true, el motivo y ninguna publicación, sin leer nada. Una cuenta desconectada responde 409 account_inactive; una cuyo token la plataforma ya no acepta, 409 token_invalid.