Overview
User Posts
Get Posts authored by a user
User mentions
Get Posts mentioning a user
Home timeline
Get personalized home feed
Reverse chronological
Posts in time order
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /2/users/:id/tweets | Get Posts by a user |
| GET | /2/users/:id/mentions | Get Posts mentioning a user |
| GET | /2/users/:id/timelines/reverse_chronological | Get home timeline |
User Posts timeline
Get the most recent Posts authored by a specific user.Features
- Up to 3,200 most recent Posts
- Filter out replies and retweets
- Pagination support
- Historical access with time-based filtering
User mentions timeline
Get Posts that mention a specific user.Features
- Up to 800 most recent mentions
- Includes replies and quote Posts
- Pagination support
Reverse chronological home timeline
Get the authenticated user’s home timeline in reverse chronological order.Features
- Posts from followed accounts
- Most recent 3,200 Posts (or 7 days)
- Excludes algorithmic ranking
- Requires user authentication
This endpoint requires OAuth 1.0a User Context or OAuth 2.0 Authorization Code with PKCE.
Filtering options
Exclude parameter
Filter out specific Post types:| Value | Effect |
|---|---|
retweets | Exclude retweets |
replies | Exclude replies |
Time-based filtering
| Parameter | Description |
|---|---|
start_time | Oldest Post timestamp (ISO 8601) |
end_time | Newest Post timestamp (ISO 8601) |
since_id | Return Posts after this ID |
until_id | Return Posts before this ID |
Getting started
Prerequisites
- An approved developer account
- A Project and App in the Developer Console
- Your App’s keys and tokens