Reading platform posts

What an account published on the platform, Antwork's posts or not, with metrics and links.

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

Request

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
  }'

The same read as the MCP fetch_platform_posts tool, for one account. maxPosts is 1 to 25, default 10. Needs the read scope.

It is a POST because it is not free: every call spends the account's API quota on the platform, and X bills per post returned. X reads are kept for a week and served from there. Each key may make 10 of these reads per 10 minutes (429 platform_read_rate_limited), beside the general limits.

Response

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 does not let a personal profile list its own posts, so one answers 200 with unsupported: true, the reason, and no posts, without reading anything. A disconnected account answers 409 account_inactive; one whose token the platform no longer accepts, 409 token_invalid.