URL rewrite

Swap x.com → tweet.md in the address bar. You get clean Markdown — plain text, never JSON.

https://x.com/jack/status/20
→ https://tweet.md/jack/status/20

Paid use in the same browser uses a session cookie after checkout or login — no ?apikey= in the URL.

02

AI agents

03

Query params

Append to any tweet.md/…/status/… URL (or /i/api/convert?url=… plus the same params). See output formats for when to use each format value. Free tier: thread=off and userinfo=off only (5 posts / IP / month) — no apikey.

Param	Default	Values
format	markdown	markdown, obsidian
thread	off · paid omit → full	off, full, or 2–100
userinfo	off · paid omit → all	off, author, all (+2 credits per unique author)
apikey	—	twmd_key_… (or Bearer header, or session cookie)

/i/api/convert also requires url (encoded X or tweet.md post URL). Prefer a session cookie in the browser over ?apikey= in links you might share.

04

Output formats

Append ?format= to any tweet.md/…/status/… URL (or the same param on /i/api/convert?url=…). Omit it for markdown.

format	When to use
markdowndefault	Default — readable notes with stats, media, quotes, and full X Articles when present.
obsidian	Vault import: YAML frontmatter (source, author, tags) plus headings per post in a thread.

Inline media in post text is rewritten to Markdown using public preview URLs from X — photos as images, videos and GIFs as labeled links to their preview JPEG.

Text:

> ![image](https://pbs.twimg.com/media/HJJrdtlWkAAiNAQ.jpg)

> [video](https://pbs.twimg.com/tweet_video_thumb/abc123.jpg)

> [animated_gif](https://pbs.twimg.com/tweet_video_thumb/HI6NThtWMAEYPhf.jpg)

Examples: https://tweet.md/jack/status/20 · https://tweet.md/jack/status/20?thread=full&format=obsidian

Use markdown for agents, notes, and browsers; obsidian when importing into an Obsidian vault.

05

X Articles

Long-form article posts use the normal status URL — tweet.md pulls the full article body automatically. Same credit as a regular post.

https://x.com/trq212/status/2052809885763747935
→ https://tweet.md/trq212/status/2052809885763747935

Use the status permalink, not x.com/i/article/… alone. Article body is plain text from X (no rich layout yet).

06

Profile fetching

Swap x.com → tweet.md in any profile URL. Returns clean Markdown with bio, stats, and recent content sections.

https://x.com/jack\n→ https://tweet.md/jack

Or use the programmatic API:

tweet.md/i/api/profile?handle=jack

Query params

Append to any tweet.md/[handle] URL. latest defaults to 5 (X API minimum); replies and articles default to off. Set any to off to skip it.

Param	Default	Values
pinnedpost	on	on, off
latest	5	off, or 5–50
replies	off	off, or 5–20
articles	off	off, or 5–20

Pricing

Base profile is 2 credits (name, bio, stats, pics). Each section adds 1 credit per post returned. Pinned post costs 1 credit when enabled and present. Profile fetching requires credits — no free tier access.

Step-by-step walkthrough: How to fetch an X profile as Markdown.

07

Apple Shortcuts

Install the prebuilt Shortcut, paste your twmd_key_… once, then convert shared or copied X URLs to Markdown from Siri, the share sheet, or your clipboard. Shortcuts should send the key as x-ios-apikey so tweet.md returns HTML-labeled content for better iOS compatibility.

Install the Shortcut Read the guide Get API key

Your API key is stored only in your local copy of the Shortcut. Do not share your customized Shortcut after adding a key. The prebuilt Shortcut uses Shortcuts’ Get Contents of URL action and asks for your key during setup.

HTTP action

GET https://tweet.md/i/api/convert?url=https%3A%2F%2Fx.com%2Fjack%2Fstatus%2F20&thread=full&format=markdown
x-ios-apikey: twmd_key_…

In Shortcuts: accept Share Sheet input, fall back to Clipboard, URL-encode the X URL, call tweet.md with x-ios-apikey, then copy, show, save, or append the returned Markdown. iOS-key requests return text/html with line breaks converted to <br> so Shortcuts handles the body as displayable content.

08