Get User Last Tweets

Get an X user’s latest tweets by username, newest first, up to 20 per page. For frequent checks of many accounts, use Twitter Stream instead.

GET /twitter/user/last_tweets

cURL

cURL

curl --request GET \
  --url https://api.twitterapi.io/twitter/user/last_tweets \
  --header 'X-API-Key: <api-key>'

200

{
  "status": "success",
  "data": {
    "pin_tweet": {
      "type": "tweet",
      "id": "<string>",
      "url": "<string>",
      "text": "<string>",
      "source": "<string>",
      "retweetCount": 123,
      "replyCount": 123,
      "likeCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "createdAt": "<string>",
      "lang": "<string>",
      "bookmarkCount": 123,
      "isReply": true,
      "inReplyToId": "<string>",
      "conversationId": "<string>",
      "displayTextRange": [
        123
      ],
      "inReplyToUserId": "<string>",
      "inReplyToUsername": "<string>",
      "author": {
        "type": "user",
        "userName": "<string>",
        "url": "<string>",
        "id": "<string>",
        "name": "<string>",
        "isBlueVerified": true,
        "verifiedType": "<string>",
        "profilePicture": "<string>",
        "coverPicture": "<string>",
        "description": "<string>",
        "location": "<string>",
        "followers": 123,
        "following": 123,
        "canDm": true,
        "createdAt": "<string>",
        "favouritesCount": 123,
        "hasCustomTimelines": true,
        "isTranslator": true,
        "mediaCount": 123,
        "statusesCount": 123,
        "withheldInCountries": [
          "<string>"
        ],
        "affiliatesHighlightedLabel": {},
        "possiblySensitive": true,
        "pinnedTweetIds": [
          "<string>"
        ],
        "isAutomated": true,
        "automatedBy": "<string>",
        "unavailable": true,
        "message": "<string>",
        "unavailableReason": "<string>",
        "profile_bio": {
          "description": "<string>",
          "entities": {
            "description": {
              "urls": [
                {
                  "display_url": "<string>",
                  "expanded_url": "<string>",
                  "indices": [
                    123
                  ],
                  "url": "<string>"
                }
              ]
            },
            "url": {
              "urls": [
                {
                  "display_url": "<string>",
                  "expanded_url": "<string>",
                  "indices": [
                    123
                  ],
                  "url": "<string>"
                }
              ]
            }
          }
        }
      },
      "entities": {
        "hashtags": [
          {
            "indices": [
              123
            ],
            "text": "<string>"
          }
        ],
        "urls": [
          {
            "display_url": "<string>",
            "expanded_url": "<string>",
            "indices": [
              123
            ],
            "url": "<string>"
          }
        ],
        "user_mentions": [
          {
            "id_str": "<string>",
            "name": "<string>",
            "screen_name": "<string>"
          }
        ]
      },
      "quoted_tweet": "<unknown>",
      "retweeted_tweet": "<unknown>",
      "isLimitedReply": true
    },
    "tweets": [
      {
        "type": "tweet",
        "id": "<string>",
        "url": "<string>",
        "text": "<string>",
        "source": "<string>",
        "retweetCount": 123,
        "replyCount": 123,
        "likeCount": 123,
        "quoteCount": 123,
        "viewCount": 123,
        "createdAt": "<string>",
        "lang": "<string>",
        "bookmarkCount": 123,
        "isReply": true,
        "inReplyToId": "<string>",
        "conversationId": "<string>",
        "displayTextRange": [
          123
        ],
        "inReplyToUserId": "<string>",
        "inReplyToUsername": "<string>",
        "author": {
          "type": "user",
          "userName": "<string>",
          "url": "<string>",
          "id": "<string>",
          "name": "<string>",
          "isBlueVerified": true,
          "verifiedType": "<string>",
          "profilePicture": "<string>",
          "coverPicture": "<string>",
          "description": "<string>",
          "location": "<string>",
          "followers": 123,
          "following": 123,
          "canDm": true,
          "createdAt": "<string>",
          "favouritesCount": 123,
          "hasCustomTimelines": true,
          "isTranslator": true,
          "mediaCount": 123,
          "statusesCount": 123,
          "withheldInCountries": [
            "<string>"
          ],
          "affiliatesHighlightedLabel": {},
          "possiblySensitive": true,
          "pinnedTweetIds": [
            "<string>"
          ],
          "isAutomated": true,
          "automatedBy": "<string>",
          "unavailable": true,
          "message": "<string>",
          "unavailableReason": "<string>",
          "profile_bio": {
            "description": "<string>",
            "entities": {
              "description": {
                "urls": [
                  {
                    "display_url": "<string>",
                    "expanded_url": "<string>",
                    "indices": [
                      123
                    ],
                    "url": "<string>"
                  }
                ]
              },
              "url": {
                "urls": [
                  {
                    "display_url": "<string>",
                    "expanded_url": "<string>",
                    "indices": [
                      123
                    ],
                    "url": "<string>"
                  }
                ]
              }
            }
          }
        },
        "entities": {
          "hashtags": [
            {
              "indices": [
                123
              ],
              "text": "<string>"
            }
          ],
          "urls": [
            {
              "display_url": "<string>",
              "expanded_url": "<string>",
              "indices": [
                123
              ],
              "url": "<string>"
            }
          ],
          "user_mentions": [
            {
              "id_str": "<string>",
              "name": "<string>",
              "screen_name": "<string>"
            }
          ]
        },
        "quoted_tweet": "<unknown>",
        "retweeted_tweet": "<unknown>",
        "isLimitedReply": true
      }
    ]
  },
  "has_next_page": true,
  "next_cursor": "<string>",
  "code": 123,
  "msg": "<string>"
}

Retrieve tweets by user name.Sort by created_at. Results are paginated, with each page returning up to 20 tweets.If you only need to fetch the latest tweets from a single user very frequently, do not use this API—it will cost you a lot. Instead, please refer to https://twitterapi.io/blog/how-to-monitor-twitter-accounts-for-new-tweets-in-real-time. If you have more than 20 Twitter accounts requiring real-time tweet updates, use https://twitterapi.io/twitter-stream which is the most cost-effective solution.

Authorizations

X-API-Key · string · header · required

Query Parameters

userId · string<string>

user id of the user.userId is recommended, could be more stable and faster than userName.userId and userName are mutually exclusive. If both are provided, userId will be used.

userName · string<string>

screen name of the user.userId and userName are mutually exclusive. If both are provided, userId will be used.

cursor · string<string>

The cursor to paginate through the results. First page is "".

includeReplies · boolean · default: false

Whether to include replies in the results. Default is False.

Response

200

application/json

Tweets response

status · enum<string> · required

Status of the request: success or error

Available options: success, error

data · object · required

Show child attributes

has_next_page · boolean · required

Indicates if there are more results available (top level, not inside data)

next_cursor · string · required

Cursor for fetching the next page of results (top level, not inside data)

code · integer

0 on success

msg · string

Message of the request (error message on failure)