Platforms / Social / X (Twitter)

Social

X (Twitter) data API

6 X (Twitter) endpoints are live: posts, replies, users, search and trends. Only successful calls that return data are billed; each endpoint's parameters, price and full response example are in the API reference.

Endpoints Open in the API reference →

A real response Full example →

@5dd0…1.2M followers

Breaking: platform updates API terms

4,021Reposts18.7KLikes922Replies

here we go again

Sample · native page style
GET /v1/raw/x/postReal response · excerpt
{
  "id": "soc_x_88c4e895916c",
  "src": "social",
  "platform": "x",
  "lang": "en",
  "text": "There's a lot of ground to cover when you're building a Moo…",
  "author": {
    "uid_hash": "99eae2f7b3d7",
    "followers": 92313359,
    "nickname": "NASA",
    "uid": "11348282",
    "unique_id": "NASA"
  },
  "metrics": {
    "likes": 3365,
    "comments": 230,
    "shares": 492,
    "quotes": 59,
    "saves": 179,
    "views": 519079
  },
  "extra": {
    "source_id": "2112560723603632217",
    "published_at": "2026-10-20T15:05:00+00:00",
    "content_type": "video",
    "cover_url": "https://pbs.twimg.com/media/HVFSyBvWAAE5Y1_.jpg",
    "video_dur_s": 46,
    "conversation_id": "2112560723603632217",
    "sensitive": false,
    "url": "https://x.com/NASA/status/2112560723603632217"
  },
  "prov": {
    "hash": "0x4e5629f2f5dedf8f",
    "ts": "2026-10-22T03:30:00+08:00",
    "source": "live"
  }
}

Make the call

curl -G https://api.qovia.ai/v1/raw/x/post \
  -H "Authorization: Bearer $QOVIA_KEY" \
  --data-urlencode "post_id=2112560723603632217"
import os, requests

resp = requests.get(
    "https://api.qovia.ai/v1/raw/x/post",
    headers={"Authorization": f"Bearer {os.environ['QOVIA_KEY']}"},
    params={"post_id": "2112560723603632217"},
)
print(resp.json()["data"])
// Add to any MCP client, then just ask in plain language
{
  "mcpServers": {
    "qovia": {
      "url": "https://api.qovia.ai/mcp",
      "headers": { "Authorization": "Bearer sk-qovia-…" }
    }
  }
}

More in Social

Your agent only knows what you give it

Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.