User Tweets timeline by User ID
GET/2/users/{id}/tweetsReturns a list of Tweets authored by the provided User ID
Request
The ID of the User to list Tweets of
The minimum Tweet ID to be included in the result set. This parameter takes precedence over start_time if both are specified.
The maximum Tweet ID to be included in the result set. This parameter takes precedence over end_time if both are specified.
The maximum number of results
The set of entities to exclude (e.g. 'replies' or 'retweets')
This parameter is used to get the next 'page' of results.
YYYY-MM-DDTHH:mm:ssZ. The earliest UTC timestamp from which the Tweets will be provided. The since_id parameter takes precedence if it is also specified.
YYYY-MM-DDTHH:mm:ssZ. The latest UTC timestamp to which the Tweets will be provided. The until_id parameter takes precedence if it is also specified.
A comma separated list of fields to expand.
A comma separated list of Tweet fields to display.
A comma separated list of User fields to display.
A comma separated list of Media fields to display.
A comma separated list of Place fields to display.
A comma separated list of Poll fields to display.
Request samples
Responses
Specifies the type of attachments (if any) present in this Tweet.
Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
Creation time of the Tweet.
The location tagged on the Tweet, if the user provided one.
Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.
Nonpublic engagement metrics for the Tweet at the time of the request.
Organic nonpublic engagement metrics for the Tweet at the time of the request.
Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.
Promoted nonpublic engagement metrics for the Tweet at the time of the request.
Engagement metrics for the Tweet at the time of the request.
A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.
Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.
The name of the app the user Tweeted from.
The content of the Tweet.
Indicates withholding details for withheld content.
A generic problem with no additional information beyond that provided by the HTTP status code.
A problem that indicates this request is invalid.
A problem that indicates your client is forbidden from making this request.
A problem that indicates that a given Tweet, User, etc. does not exist.
A problem that indicates a particular Tweet, User, etc. is not available to you.
A problem that indicates you are not allowed to see a particular Tweet, User, etc.
A problem that indicates that you are not allowed to see a particular field on a Tweet, User, etc.
A problem that indicates that the resource requested violates the precepts of this API.
A problem that indicates that the authentication used is not supported.
A problem that indicates that a usage cap has been exceeded.
A problem that indicates something is wrong with the connection
Your client has gone away.
You have been disconnected for operational reasons.
You have exceeded the maximum number of rules.
The rule you have submitted is invalid.
The rule you have submitted is a duplicate.
You cannot create a new job if one is already in progress.
Newest Tweet ID in the result set
The next token
Oldest Tweet ID in the result set
The previous token
Number of Tweets in result set
{
"data": [
{
"author_id": "2244994945",
"created_at": "Wed Jan 06 18:40:40 +0000 2021",
"id": "1346889436626259968",
"text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
],
"errors": [
{
"detail": "string",
"title": "string",
"status": 0,
"type": "about:blank"
}
],
"includes": {
"media": [
{
"height": 0,
"media_key": "string",
"width": 0,
"alt_text": "string",
"type": "photo",
"url": "http://example.com"
}
],
"places": [
{
"contained_within": [
"f7eb2fa2fea288b1"
],
"country": "United States",
"country_code": "US",
"full_name": "Lakewood, CO",
"geo": {
"bbox": [
-105.193475,
39.60973,
-105.053164,
39.761974
],
"geometry": {
"coordinates": [
-105.18816086351444,
40.247749999999996
],
"type": "Point"
},
"properties": {},
"type": "Feature"
},
"id": "f7eb2fa2fea288b1",
"name": "Lakewood",
"place_type": "city"
}
],
"polls": [
{
"duration_minutes": 0,
"end_datetime": "2019-08-24T14:15:22.123Z",
"id": "1365059861688410112",
"options": [
{
"label": "string",
"position": 0,
"votes": 0
},
{
"label": "string",
"position": 0,
"votes": 0
}
],
"voting_status": "open"
}
],
"tweets": [
{
"author_id": "2244994945",
"created_at": "Wed Jan 06 18:40:40 +0000 2021",
"id": "1346889436626259968",
"text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
],
"users": [
{
"created_at": "2013-12-14T04:35:55Z",
"id": "2244994945",
"name": "Twitter Dev",
"protected": false,
"username": "TwitterDev"
}
]
},
"meta": {
"newest_id": "1346889436626259968",
"next_token": "string",
"oldest_id": "1346889436626259968",
"previous_token": "string",
"result_count": 0
}
}