Overview
User Reads: Read a profile, its timeline, media, mentions, affiliates, and follow relationships by username or numeric ID.
Read a profile, its timeline, media, mentions, affiliates, and follow relationships by username or numeric ID.
This category has 14 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
GET | /user/info | $0.0008 | Fetch a full profile by @handle. |
GET | /user/info_by_id | $0.0008 | Fetch a full profile by numeric user ID. |
GET | /user/user_about | $0.0008 | Fetch a profile's extended About / professional details. |
GET | /user/media | $0.0008 | Page through a profile's media tweets (images and video). |
GET | /user/tweets | $0.0008 | Fetch a user's public timeline (original tweets, retweets, and their own replies). |
GET | /user/tweets_and_replies | $0.0008 | Fetch a user's timeline including their replies (same upstream timeline as User Tweets). |
GET | /user/mentions | $0.0008 | Fetch tweets that mention a username. |
GET | /user/affiliates | $0.0008 | List the affiliated sub-accounts of an organization profile. |
GET | /user/check_follow_relationship | $0.0008 | Check whether one user follows another. |
GET | /user/bookmarks | $0.0008 | List your registered account's bookmarked tweets, most recent first. |
GET | /user/bookmark_search | $0.0008 | Full-text search within your registered account's bookmarks. |
GET | /user/likes | $0.0008 | Fetch the tweets a target account has liked (its public Likes tab). |
GET | /user/home_timeline | $0.0008 | Fetch your registered account's home timeline (the For You / Following feed). |
GET | /user/tweets/complete | $0.0024 | Auto-paginate a large batch of a user's tweet history per call, resuming with a cursor up to Twitter's ~3200 ceiling. |
User Info by Username
Fetch a full profile by @handle.
User Info by ID
Fetch a full profile by numeric user ID.
User About
Fetch a profile's extended About / professional details.
User Media
Page through a profile's media tweets (images and video).
User Tweets
Fetch a user's public timeline (original tweets, retweets, and their own replies).
User Tweets and Replies
Fetch a user's timeline including their replies (same upstream timeline as User Tweets).
User Mentions
Fetch tweets that mention a username.
User Affiliates
List the affiliated sub-accounts of an organization profile.
Check Follow Relationship
Check whether one user follows another.
Bookmarks
List your registered account's bookmarked tweets, most recent first.
Bookmark Search
Full-text search within your registered account's bookmarks.
User Likes
Fetch the tweets a target account has liked (its public Likes tab).
Home Timeline
Fetch your registered account's home timeline (the For You / Following feed).
Full Tweet History
Auto-paginate a large batch of a user's tweet history per call, resuming with a cursor up to Twitter's ~3200 ceiling.
Tweet Thread GET
Given the first tweet of a thread, return the ordered list of tweets that make up the author's connected thread. The endpoint reads forward from the tweet you pass and does not walk backwards, so pass the thread's first tweet, which is the conversation_id carried on every tweet in that thread. Passing a later tweet returns only the tail of the thread. Cost: $0.0040 per call.
User Info by Username GET
Resolve a username into the full user object: bio, follower and following counts, verification status, location, and avatar. The canonical entry point for profile lookups. Cost: $0.0008 per call.