User Tweet timeline by ID
GET https://api.twitter.com/2/users/:id/tweets
Returns the most recent Tweets composed by a single user specified by the requested user ID.
For full details, see the API reference for this endpoint.
Sign up for the Twitter API
Request Params
| Key | Datatype | Required | Description |
| max_results
| null | | Specifies the number of Tweets to try and retrieve, up to a maximum of 100 per distinct request.
Retweets and replies are included in the count, even if exclude=retweets,replies
are supplied.
By default, 10 results are returned if this parameter is not supplied. The minimum permitted value is 5.
|
| start_time
| null | | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The oldest or earliest UTC timestamp from which the Tweets will be provided. Only the 3200 most recent Tweets are available. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute). Minimum allowable time is 2010-11-06T00:00:00Z |
| end_time
| null | | YYYY-MM-DDTHH:mm:ssZ (ISO 8601/RFC 3339). The oldest or earliest UTC timestamp from which the Tweets will be provided. Only the 3200 most recent Tweets are available. Timestamp is in second granularity and is inclusive (i.e. 12:00:01 includes the first second of the minute). Minimum allowable time is 2010-11-06T00:00:00Z |
| since_id
| null | | Returns results with an ID greater than (that is, more recent than) the specified ID. Only the 3200 most recent Tweets are available. The result will exclude the since_id
. If the limit of Tweets has occurred since the since_id
, the since_id
will be forced to the oldest ID available. |
| until_id
| null | | Returns results with an ID less less than (that is, older than) the specified ID. Only the 3200 most recent Tweets are available. The result will exclude the until_id
. If the limit of Tweets has occurred since the until_id
, the until_id
will be forced to the most recent ID available. |
| pagination_token
| null | | This parameter is used to move forwards or backwards through pages of results, based on the value of the next_token
or previous_token
in the response. The value used with the parameter is pulled directly from the response provided by the API, and should not be modified. |
| expansions
| null | | Comma-separated list of fields to expand. Expansions enable requests to expand an ID into a full object in the includes response object.
Allowed values: attachments.poll_ids,attachments.media_keys,author_id,geo.place_id,in_reply_to_user_id,referenced_tweets.id,entities.mentions.username,referenced_tweets.id.author_id,edit_history_tweet_ids
Default values: none |
| tweet.fields
| null | | Comma-separated list of fields for the Tweet object.
Allowed values: attachments,author_id,context_annotations,conversation_id,created_at,entities,geo,id,in_reply_to_user_id,lang,non_public_metrics,organic_metrics,possibly_sensitive,promoted_metrics,public_metrics,referenced_tweets,reply_settings,source,text,withheld,edit_history_tweet_ids,edit_controls
Default values:
id,text,edit_history_tweet_ids |
| user.fields
| null | | Comma-separated list of fields for the user object. Expansion required.
Allowed values: created_at,description,entities,id,location,name,pinned_tweet_id,profile_image_url,protected,public_metrics,url,username,verified,withheld
Default values:
id,name,username |
| media.fields
| null | | Comma-separated list of fields for the media object. Expansion required.
Allowed values: duration_ms,height,media_key,non_public_metrics,organic_metrics,preview_image_url,promoted_metrics,public_metrics,type,url,width
Default values:
media_key,type |
| place.fields
| null | | Comma-separated list of fields for the place object. Expansion required.
Allowed values: contained_within,country,country_code,full_name,geo,id,name,place_type
Default values:
id,full_name |
| poll.fields
| null | | Comma-separated list of fields for the poll object. Expansion required.
Allowed values: duration_minutes,end_datetime,id,options,voting_status
Default values: id, options |
HEADERS
| Key | Datatype | Required | Description |
RESPONSES
status: ``