REST API for AI Agents

Give your agents
eyes for X posts.

TweetRead extracts tweet text and linked article content from any X post — returning clean, structured JSON your agents can actually use.

✓ No browser requiredTweet text via oEmbedFull article extractionWorks with OpenClaw, n8n, MakeREST JSON API

Live Demo

tweetread.dev — interactive demo

— output

// Output will appear here
// Try: https://x.com/OpenAI/status/...

What it does

🐦

Tweet Text

Extracts tweet body via Twitter's official oEmbed API. No auth, no scraping, no blocks.

📄

Linked Articles

Automatically detects URLs in tweets, fetches and extracts the full article text — not just the headline.

⚡

Agent-Ready JSON

Returns structured JSON your agents can consume directly. Plug into OpenClaw, n8n, Make, or any HTTP client.

API Reference

curl -X GET \
  "https://tweetread.vercel.app/api/extract?url=URL" \
  -H "x-api-key: YOUR_API_KEY"

Endpoint

GETPOST/api/extract

Parameter	Type	Where	Description
url	string	query / body	X post URL or any article URL to extract
api_key	string	header / query	Via `x-api-key`, `Authorization: Bearer`, or `?api_key=`

Response Schema

Field	Type	Description
data.source	string	The original URL passed in
data.type	enum	"tweet" \| "article" \| "tweet+article"
data.tweet.text	string	The tweet body text
data.tweet.author	string	Display name of the author
data.tweet.authorHandle	string	Twitter handle
data.tweet.linkedUrls	string[]	External URLs found in the tweet
data.article.title	string	Article headline
data.article.text	string	Full article body (up to 8,000 chars)
data.article.domain	string	Source domain (e.g. "techcrunch.com")
data.wordCount	number	Total word count of extracted content
data.extractedAt	string	ISO 8601 timestamp of extraction
data.errors	string[]	Non-fatal errors (e.g. article blocked)

Give your agentseyes for X posts.