tubestat

API Reference

X (Twitter) endpoints

Profile, post and Space metrics. Both x.com and twitter.com URLs are accepted.

All 3 endpoints below take a single url parameter and return the same field vocabulary used across every platform. A full object costs 2 credits; a single field costs 1.
GET /api/v1/twitter/user
2 credits cache 1m

X profile

Follower, following, post, list and media counts for an X (Twitter) account.

Parameters

url required
Example: https://x.com/username
field optional
Return a single value for 1 credit instead of 2.

Fields

userId · username · displayName · followers · following · posts · lists · media · private · verified

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/twitter/user?url=https%3A%2F%2Fx.com%2Fusername"
GET /api/v1/twitter/post
2 credits cache 1m

X post

Like, repost, reply, quote, bookmark and view counts for an X post, including poll results when present.

Parameters

url required
Example: https://x.com/username/status/POST_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

postId · authorId · authorName · likes · reposts · comments · quotes · saves · views · pollTotalVotes · pollOptions

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/twitter/post?url=https%3A%2F%2Fx.com%2Fusername%2Fstatus%2FPOST_ID"
GET /api/v1/twitter/space
2 credits cache 1m

X Space

Listener and replay counts for an X Space.

Parameters

url required
Example: https://x.com/i/spaces/SPACE_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

spaceId · status · title · creatorId · creatorUsername · listeners · replays

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/twitter/space?url=https%3A%2F%2Fx.com%2Fi%2Fspaces%2FSPACE_ID"