🧵 No X API key needed

ThreadReader API

Extract full X/Twitter threads as clean JSON, markdown, or plain text. One endpoint. Instant value. Built for AI agents.

Live Demo

Endpoint

GET /api/thread?url={tweet_url}

Headers:
  X-Api-Key: sk_your_key

Query params:
  url      - Tweet URL (required)
  format   - json | md | text
  api_key  - Alternative to header

Response

{
  "author": {
    "name": "Elon Musk",
    "handle": "elonmusk"
  },
  "thread": [{
    "text": "First tweet...",
    "created_at": "2026-01-01",
    "likes": 1234,
    "retweets": 567
  }],
  "meta": {
    "tweet_count": 5,
    "total_likes": 12890
  }
}
Free
$0/mo
  • ✓ 50 requests / day
  • ✓ JSON + Markdown + Text
  • ✓ 15 min cache
  • ✓ API key required
Popular
Pro
$9/mo
  • ✓ 5,000 requests / day
  • ✓ JSON + Markdown + Text
  • ✓ 15 min cache
  • ✓ Priority support

Quick Start

# Fetch a thread as JSON
curl "https://read.shipshit.dev/api/thread?url=https://x.com/user/status/123" \
  -H "X-Api-Key: sk_your_key"

# Get as markdown (perfect for LLMs)
curl "https://read.shipshit.dev/api/thread?url=...&format=md" \
  -H "X-Api-Key: sk_your_key"

# Python
import requests
r = requests.get(
  "https://read.shipshit.dev/api/thread",
  params={"url": "https://x.com/user/status/123"},
  headers={"X-Api-Key": "sk_your_key"}
)
thread = r.json()