The X data API

X data,
relayed.

One clean REST API for X data — users, tweets, search, followers, lists, communities. Predictable JSON, one header to authenticate, pay per call in credits.

OAuth-grade upstream auth · 30 read endpoints · x-api-key auth · no monthly minimum

● stable, versioned JSON ·✓ 30 read endpoints live ·✓ credits, pay per call ·✓ no monthly minimum
What you can build

One API, many jobs.

Point RelayX at the slice of X you need — the read surface spans profiles, posts, search, the follow graph, lists, communities, spaces and trends.

Social listening

Track topics, hashtags and accounts with search, mentions and timelines — fresh on every call.

search · mentions · timelines

Research & datasets

Hydrate users and tweets in bulk, walk follower graphs, and pull whole communities for market or academic work.

batch lookups · followers · communities

Growth & analytics

Measure reach with retweeters, quotes and verified-follower breakdowns for any public account.

retweeters · quotes · verified followers

Context for AI

Feed clean, predictable JSON of posts and profiles into LLM pipelines, agents and eval sets.

profiles · posts · threads
Quickstart

One key.
One GET.

No SDK to learn and no OAuth dance. Send your key in the x-api-key header, hit a plain REST path, and read JSON back — with your remaining credits in the response headers.

# 1 · authenticate
export RELAYX_KEY=rk_live_9f2c…
# 2 · call
curl https://api.relayxapi.com/twitter/user/last_tweets?userName=nasa \
  -H "x-api-key: $RELAYX_KEY"
# → JSON + x-credits-remaining. done.
What you can call

The read surface, in full.

Users, tweets, timelines, search, lists, communities, spaces, trends — with per-call credit cost.

GET /twitter/user/info15
GET /twitter/user/last_tweets13 / tweet
GET /twitter/user/followers3 → 1 / follower
GET /twitter/user/mentions13 / tweet
GET /twitter/tweet/advanced_search13 / tweet
GET /twitter/tweet/thread_context13 / tweet
GET /twitter/tweet/retweeters15 / user
GET /twitter/list/tweets_timeline13 / tweet
GET /twitter/community/tweets13 / tweet
GET /twitter/spaces/detail15
GET /twitter/trends15
GET /account/credits0
See all 30+ endpoints in the docs →

Endpoints X's own apps don't expose — community members and moderators, all-community search, article-by-id — return a plain 501 with a reason. See the endpoint notes in the docs.

Pricing

Buy credits. Spend per call.

1 USD = 100,000 credits. No subscription, no monthly minimum, and credits don't expire. You're billed per item returned — deeper pages cost less per item.

Per-call rates
Tweets13 each$0.13 per 1K
User profiles15 each$0.15 per 1K
Followers & following3 → 1tiered by page fill
Follower IDs2 → 0.4tiered by page fill
Single lookups (info, trends, space…)15 each
Follow-relationship check30 each
Unsupported endpointsfree · 501

Every call has a 15-credit floor, automatically waived on bulk responses. Credits never expire.

Throughput scales with your balance

Requests per second rise with the credits you keep on your key — park more, go faster.

Credit balanceRequests / sec
Free / trial1
≥ 1,000 credits3
≥ 5,000 credits6
≥ 10,000 credits10
≥ 50,000 credits20
FAQ

Questions, answered.

Do I need an X developer account to use RelayX?

No. You only need a RelayX API key. You call a simple REST API with your key in the X-API-Key header, and RelayX handles access to X.

How is RelayX priced?

Pay as you go: 1 USD buys 100,000 credits, and you pay per item returned — for example 13 credits per tweet and 15 per user profile. There's no subscription or monthly minimum, and credits don't expire.

Is there a free trial?

Yes. Your first API key comes with free trial credits, so you can test real calls before buying.

What X data can I get?

Public user profiles, tweets, replies, quotes, advanced search, followers and following, lists, communities, Spaces and trends.

Are there rate limits?

Throughput scales with the credit balance on your key: requests per second rise as you keep more credits on it, starting at 1 request per second on the free tier.

Is RelayX affiliated with X?

No. RelayX is an independent service and is not affiliated with, endorsed by, or operated by X Corp.

Ship your first call in a minute.

Grab a key, change one URL, read JSON you already know how to parse.

Get an API key