v3

latestOpenAPI 3.0.32026-08-02415689.9 KB
Tweets

Article Data

Returns full data for a Twitter/X Article (long-form post) by its URL. The response includes the complete article text, a short preview excerpt, cover image URL, publication date, engagement metrics, and the author's profile.

post/article

Request body

tweet_linkstring

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

Response

OK

bookmark_countinteger

Number of bookmarks.

cover_image_urlstring

URL of the article's cover image.

full_textstring

Complete article text.

likes_countinteger

Number of likes.

preview_textstring

Short preview or excerpt of the article.

published_atstring

Publication date in ISO 8601 format.

quote_countinteger

Number of quote tweets.

reply_countinteger

Number of replies.

retweet_countinteger

Number of retweets.

views_countinteger

Number of views (impressions).

Example response

{
  "author": {
    "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
  }
}