Get a viral post

One X post or video from the viral library, by its id.

Request

curl -X GET "https://www.postel.app/api/v1/viral/posts/1853398412345678901"

curl -X GET "https://www.postel.app/api/v1/viral/posts/1853398412345678901"

Response

200

{
  "id": "1853398412345678901",
  "network": "x",
  "url": "https://x.com/jane/status/1853398412345678901",
  "title": null,
  "text": "I deleted our onboarding and signups went up 40%.\n\nHere's what we replaced it with:",
  "author": {
    "handle": "jane",
    "name": "Jane Park",
    "followers": 4200
  },
  "postedAt": "2026-11-02T14:05:00.000Z",
  "views": 389000,
  "likes": 5100,
  "comments": 312,
  "reposts": 640,
  "outlierScore": 92.6,
  "outlierBasis": "followers",
  "format": "the-numbers",
  "isShort": null
}

Try it

Authorization

bearerAuth

AuthorizationBearer <token>

A Postel API key, Authorization: Bearer pstl_…. Create one in Postel under Settings → API & MCP; it acts for the workspace it was made in.

In: header

Path parameters

id*string

The viral post's id from GET /v1/viral/posts

Try it

Authorization

Path parameters

Responses

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Get a viral post

Try it

Authorization

Path parameters

Responses

200application/json

401application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`