v1

latestOpenAPI 3.0.0Twitter Developer Agreement and Policy2026-07-1480235216.3 KB
Tweets

User Tweets timeline by User ID

Returns a list of Tweets authored by the provided User ID

get/2/users/{id}/tweets

Path parameters

idstring required

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.

Example:2244994945

The ID of the User to lookup.

Query parameters

since_idstring

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.

Example:1346889436626259968

The minimum Tweet ID to be included in the result set. This parameter takes precedence over start_time if both are specified.

until_idstring

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.

Example:1346889436626259968

The maximum Tweet ID to be included in the result set. This parameter takes precedence over end_time if both are specified.

max_resultsinteger

The maximum number of results.

pagination_tokenstring

A base36 pagination token.

This parameter is used to get the next 'page' of results.

excludestring[]

The set of entities to exclude (e.g. 'replies' or 'retweets').

[
  "replies",
  "retweets"
]
start_timestring date-time

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.

end_timestring date-time

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.

tweet.fieldsstring[]

The fields available for a Tweet object.

A comma separated list of Tweet fields to display.

[
  "attachments",
  "author_id",
  "context_annotations",
  "conversation_id",
  "created_at",
  "edit_controls",
  "edit_history_tweet_ids",
  "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"
]
expansionsstring[]

The list of fields you can expand for a Tweet object. If the field has an ID, it can be expanded into a full object.

A comma separated list of fields to expand.

[
  "attachments.media_keys",
  "attachments.poll_ids",
  "author_id",
  "edit_history_tweet_ids",
  "entities.mentions.username",
  "geo.place_id",
  "in_reply_to_user_id",
  "referenced_tweets.id",
  "referenced_tweets.id.author_id"
]
media.fieldsstring[]

The fields available for a Media object.

A comma separated list of Media fields to display.

[
  "alt_text",
  "duration_ms",
  "height",
  "media_key",
  "non_public_metrics",
  "organic_metrics",
  "preview_image_url",
  "promoted_metrics",
  "public_metrics",
  "type",
  "url",
  "variants",
  "width"
]
poll.fieldsstring[]

The fields available for a Poll object.

A comma separated list of Poll fields to display.

[
  "duration_minutes",
  "end_datetime",
  "id",
  "options",
  "voting_status"
]
user.fieldsstring[]

The fields available for a User object.

A comma separated list of User fields to display.

[
  "created_at",
  "description",
  "entities",
  "id",
  "location",
  "name",
  "pinned_tweet_id",
  "profile_image_url",
  "protected",
  "public_metrics",
  "url",
  "username",
  "verified",
  "verified_type",
  "withheld"
]
place.fieldsstring[]

The fields available for a Place object.

A comma separated list of Place fields to display.

[
  "contained_within",
  "country",
  "country_code",
  "full_name",
  "geo",
  "id",
  "name",
  "place_type"
]

Response

The request has succeeded.

Example response

{
  "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"
    }
  ],
  "includes": {
    "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"
          }
        },
        "id": "f7eb2fa2fea288b1",
        "name": "Lakewood",
        "place_type": "city"
      }
    ],
    "polls": [
      {
        "id": "1365059861688410112"
      }
    ],
    "topics": [
      {
        "description": "All about technology",
        "name": "Technology"
      }
    ],
    "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"
      }
    ]
  }
}