Posts and threads

Read a single post, follow an author's thread, or include the surrounding conversation.

Read a post

GET /{handle}/status/{id} — the permalink form. Swap x.com for x.pcstyle.dev and keep the path.

curl -sS 'https://x.pcstyle.dev/trq212/status/2052809885763747935?thread=off'

GET /api/v1/posts — the same reader on the versioned surface, for a client that holds a URL rather than a path. Identify the post either with url, or with the handle and id pair.

# By URL
curl -sS -G 'https://x.pcstyle.dev/api/v1/posts' \
  --data-urlencode 'url=https://x.com/trq212/status/2052809885763747935' \
  --data-urlencode 'thread=off'

# Or by handle and id
curl -sS 'https://x.pcstyle.dev/api/v1/posts?handle=trq212&id=2052809885763747935'

Both forms take the same options and return the same body. Without thread=off, the default response includes available parents, the author’s thread, and top replies. Each returned post links to its X source.

Media permalinks resolve to the same post: /{handle}/status/{id}/photo/1 and /video/1 read the post they belong to.

Control the conversation

# Author thread, capped at 20 posts
curl -sS 'https://x.pcstyle.dev/trq212/status/2052809885763747935?context=thread&thread=20'

# Expanded details, without unrelated replies
curl -sS 'https://x.pcstyle.dev/trq212/status/2052809885763747935?full=true&replies=off'

Parameter	Default	Values
`url`	—	A public `x.com` or `twitter.com` status permalink. `/api/v1/posts` only
`handle`, `id`	—	Alternative to `url`: a handle of 1–15 word characters and a numeric status id. `/api/v1/posts` only
`thread`	`full`	`off`, `full`, `conversation`, or a count from `2` to `100`
`context`	`full`	`full` for surrounding context; `thread` for the direct author chain
`replies`	`top`	`top`, `recent`, `off`
`userinfo`	`off`	`off`, `author`, `all`
`full`	`false`	`true` adds dates, stats, and expanded details
`format`	`markdown`	`markdown`, `json`, `obsidian`
`nocache`	`false`	`true` bypasses application caching

Post boolean parameters accept true, 1, or yes. The thread count is separate from the 20-result limit on search and profile routes.

Media and articles

Responses include available image links, video URLs, thumbnails, and media variants. X Articles are included when the source supplies their content. Media is linked, not downloaded; CDN links can expire.

Save to Obsidian

curl -sS 'https://x.pcstyle.dev/trq212/status/2052809885763747935?format=obsidian' > post.md

Obsidian output includes frontmatter and expanded details regardless of full.

Paste an x.md status URL into Discord, Telegram, or Slack for a rich preview. Preview bots receive Open Graph HTML. Ordinary requests receive Markdown; explicit format or Accept takes precedence.

GET /oembed?url={original X URL} returns the oEmbed metadata; GET /api/v1/oembed is the same document on the versioned surface.