docs / twitter

Twitter / X Data API

base /twitter/v114 endpoints

post/twitter/v1/profile1 credit

User profile by @username — name, bio, followers, following, tweet/like counts, verified, created date, location, website, avatar/banner.

Parameter		Allowed / range	Description
username	required	—	The @handle (with or without @).

Try in playground →

post/twitter/v1/user_by_id1 credit

User profile by numeric user_id (same fields as profile).

Parameter		Allowed / range	Description
user_id	required	—	Numeric user id.

Try in playground →

post/twitter/v1/user_tweets1 credit

A user's tweets — full text, engagement (likes/retweets/replies/quotes/views), media, quoted/retweeted, with cursor pagination.

Parameter		Allowed / range	Description
username	optional	—	@handle (resolved to id) — or pass user_id.
user_id	optional	—	Numeric user id (skips the handle lookup).
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/user_replies1 credit

A user's tweets AND replies (timeline incl. replies). Each reply also carries reply_to_text (the parent tweet's text, ≤280 chars) + reply_to_author so a reply is interpretable without a second call — resolved from the conversation already in the response.

Parameter		Allowed / range	Description
username	optional	—	@handle — or pass user_id.
user_id	optional	—	Numeric user id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/user_media1 credit

A user's media tweets — photos & videos (with video_url + duration), engagement, pagination.

Parameter		Allowed / range	Description
username	optional	—	@handle — or pass user_id.
user_id	optional	—	Numeric user id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/user_likes1 credit

Tweets a user has liked (if the account exposes likes).

Parameter		Allowed / range	Description
username	optional	—	@handle — or pass user_id.
user_id	optional	—	Numeric user id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/tweet1 credit

A single tweet by id — full text, engagement, media, quoted/retweeted, author.

Parameter		Allowed / range	Description
tweet_id	required	—	The tweet (status) id.

Try in playground →

post/twitter/v1/tweet_replies1 credit

A tweet PLUS its replies/comments (threaded conversation) with DEEP cursor pagination.

Parameter		Allowed / range	Description
tweet_id	required	—	The tweet id to load replies for.
limit = 40	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/search1 credit

Search tweets or people. product=Top|Latest|People|Media. Supports X search operators in the query. Cursor pagination.

Parameter		Allowed / range	Description
query	required	—	Search text (supports operators like from:, since:, filter:media).
product = Top	optional	Top · Latest · People · Media	Result type.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/followers1 credit

A user's followers (each a full user object), paginated.

Parameter		Allowed / range	Description
username	optional	—	@handle — or pass user_id.
user_id	optional	—	Numeric user id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/following1 credit

Accounts a user follows (each a full user object), paginated.

Parameter		Allowed / range	Description
username	optional	—	@handle — or pass user_id.
user_id	optional	—	Numeric user id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/list_tweets1 credit

Latest tweets from a Twitter List by id, paginated.

Parameter		Allowed / range	Description
list_id	required	—	The List id.
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

post/twitter/v1/trends1 credit

Current trending topics on X / Twitter (the Explore feed) — each with its name, location/category context, post-volume, and a search URL.

Parameter		Allowed / range	Description
limit = 40	optional	1–100	Max items to return.

Try in playground →

post/twitter/v1/community_search1 credit

Search posts across X Communities by keyword — returns matching community tweets (same rich tweet shape as search).

Parameter		Allowed / range	Description
query	required	—	Keywords to search within X Communities.
product	optional	Top · Latest	Latest (chronological) or Top (relevance).
limit = 20	optional	1–100	Max items to return.
cursor	optional	—	Pagination cursor from a previous response's next_cursor.

Try in playground →

Example request · profile

curl -X POST https://api.reefapi.com/twitter/v1/profile \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}