TwitterAPIs API Reference
A pay-per-call Twitter/X data API. Authenticate with a bearer token, call any read endpoint for $0.0008 per request (~20 tweets), and page results with cursors. Write actions (like, retweet, bookmark, follow) are $0.0015 per call. The account/* endpoints are free.
Authentication
Pass your API key as a bearer token on every request. New accounts get $0.50 in free credits at signup, no card required.
curl "https://api.twitterapis.com/user/info?username=naval"
-H "Authorization: Bearer $TWITTERAPIS_KEY"Search
Full-text and structured search across tweets and users. Filter by query operators, author, date, language, and engagement.
Tweet Details
Resolve a single tweet into its full object: replies, retweeters, and the complete conversation thread.
tweet/detail$0.0008Fetch a single tweet's full object by ID.
Read reference→tweet/replies$0.0008Page through the replies to a tweet.
Read reference→tweet/retweeters$0.0008List the users who retweeted a tweet.
Read reference→tweet/thread$0.0008Reconstruct a full thread from any tweet in it.
Read reference→User Reads
Read a profile, its timeline, media, mentions, affiliates, and follow relationships by username or numeric ID.
user/info$0.0008Fetch a full profile by @handle.
Read reference→user/info_by_id$0.0008Fetch a full profile by numeric user ID.
Read reference→user/user_about$0.0008Fetch a profile's extended About / professional details.
Read reference→user/media$0.0008Page through a profile's media tweets (images and video).
Read reference→user/tweets$0.0008Fetch a user's timeline (original tweets and retweets).
Read reference→user/tweets_and_replies$0.0008Fetch a user's timeline including their replies.
Read reference→user/mentions$0.0008Fetch tweets that mention a username.
Read reference→user/affiliates$0.0008List the affiliated sub-accounts of an organization profile.
Read reference→user/check_follow_relationship$0.0008Check whether one user follows another.
Read reference→Follower Graph
Page through followers and following lists, including the verified-only and v2 cursor-paginated variants.
user/followers$0.0008Page through the accounts that follow a user.
Read reference→user/following$0.0008Page through the accounts a user follows.
Read reference→user/followers_v2$0.0008Followers endpoint with the v2 response shape and richer cursoring.
Read reference→user/following_v2$0.0008Following endpoint with the v2 response shape and richer cursoring.
Read reference→user/verified_followers$0.0008Page through only the verified accounts that follow a user.
Read reference→List Data
Read the members of any public Twitter/X List.
Write Actions
Act on behalf of an authenticated account: like, retweet, bookmark, and follow, each with its undo. Billed at $0.0015 per call.
tweet/favorite$0.0015Like (favorite) a tweet on behalf of an authenticated account.
Read reference→tweet/unfavorite$0.0015Remove a like (unfavorite) from a tweet.
Read reference→tweet/retweet$0.0015Retweet a tweet on behalf of an authenticated account.
Read reference→tweet/unretweet$0.0015Remove a retweet from a tweet.
Read reference→tweet/bookmark$0.0015Add a tweet to the authenticated account's bookmarks.
Read reference→tweet/unbookmark$0.0015Remove a tweet from the authenticated account's bookmarks.
Read reference→user/follow$0.0015Follow a user on behalf of an authenticated account.
Read reference→user/unfollow$0.0015Unfollow a user on behalf of an authenticated account.
Read reference→Account
Read your own account: remaining credits, plan, and the per-call payment ledger. These calls are free.