latestOpenAPI 3.0.32026-08-02415689.9 KB

7742c72d6966

Tweets

Tweet Data

Returns full data for a single tweet by its URL: text, creation date, language, engagement metrics (likes, retweets, quotes, replies, views, bookmarks), and the author's profile. If the tweet is a reply, quote, or repost, the nested original tweet and its author data are included as well.

post/tweet-info

Request body

tweet_linkstring

Full URL of the tweet (e.g. https://x.com/user/status/123) or just the tweet ID.

Response

OK

bookmark_countinteger

Number of times the tweet has been bookmarked.

conversation_id_strstring

ID of the root tweet in the conversation thread.

created_atstring

Tweet publication date in ISO 8601 format.

full_textstring

Full text content of the tweet.

idstring

Unique tweet ID.

in_reply_to_tweet_idstring

ID of the tweet this tweet is replying to. Null if not a reply.

in_reply_to_usernamestring

Username of the account this tweet is replying to.

is_quote_statusboolean

Whether this tweet quotes another tweet.

is_replies_limitedboolean

Whether replies to this tweet are restricted by the author.

is_replyboolean

Whether this tweet is a reply to another tweet.

langstring

Detected language code of the tweet (e.g. en, es).

likes_countinteger

Number of likes on the tweet.

made_with_aiboolean

Whether the tweet was made with AI.

paid_partnershipboolean

Whether the tweet is a paid partnership.

quote_countinteger

Number of quote tweets.

reply_countinteger

Number of replies to the tweet.

retweet_countinteger

Number of retweets.

view_countinteger

Number of views (impressions).

Example response

{
  "bookmark_count": 15,
  "conversation_id_str": "1782368585664626774",
  "created_at": "2024-01-15T10:30:00Z",
  "entities": [
    {
      "link": "https://t.co/example",
      "preview": "https://pbs.twimg.com/preview",
      "type": "photo"
    }
  ],
  "full_text": "Hello world",
  "id": "1782368585664626774",
  "in_reply_to_tweet_id": "1782368585664626000",
  "in_reply_to_username": "username",
  "lang": "en",
  "likes_count": 200,
  "quote_count": 5,
  "reply_count": 10,
  "retweet_count": 50,
  "user": {
    "created_at": "2009-06-02T20:12:29Z",
    "description": "Bio text",
    "display_name": "Elon Musk",
    "favourites_count": 1200,
    "followers_count": 100000,
    "followings_count": 500,
    "id": "44196397",
    "location": "Austin, TX",
    "media_count": 300,
    "profile_background_image_url": "https://pbs.twimg.com/profile_banners/44196397/123",
    "profile_image_url": "https://pbs.twimg.com/profile_images/123/photo.jpg",
    "tweets_count": 5000,
    "username": "elonmusk",
    "verified": true
  },
  "view_count": 10000
}