---
title: "Tweet Data"
method: POST
path: "/tweet-info"
tags: ["Tweets"]
---

# Tweet Data

`POST /tweet-info`

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.

## Request body

- TweetsTweetInfoReq
  - `tweet_link` string — Full URL of the tweet (e.g. `https://x.com/user/status/123`) or just the tweet ID.

## Response `200`

OK

- CommonTweet
  - `bookmark_count` integer — Number of times the tweet has been bookmarked.
  - `conversation_id_str` string — ID of the root tweet in the conversation thread.
  - `created_at` string — Tweet publication date in ISO 8601 format.
  - `entities` CommonTweetEntity[] — Media, links, and other embedded entities attached to the tweet.
    - `link` string — Direct URL of the entity.
    - `preview` string — Preview or thumbnail URL for the entity.
    - `type` string — Entity type (e.g. `photo`, `video`, `url`).
  - `full_text` string — Full text content of the tweet.
  - `id` string — Unique tweet ID.
  - `in_reply_to_tweet_id` string — ID of the tweet this tweet is replying to. Null if not a reply.
  - `in_reply_to_username` string — Username of the account this tweet is replying to.
  - `is_quote_status` boolean — Whether this tweet quotes another tweet.
  - `is_replies_limited` boolean — Whether replies to this tweet are restricted by the author.
  - `is_reply` boolean — Whether this tweet is a reply to another tweet.
  - `lang` string — Detected language code of the tweet (e.g. `en`, `es`).
  - `likes_count` integer — Number of likes on the tweet.
  - `made_with_ai` boolean — Whether the tweet was made with AI.
  - `paid_partnership` boolean — Whether the tweet is a paid partnership.
  - `quote_count` integer — Number of quote tweets.
  - `quoted_status` CommonTweet — recursive
  - `reply_count` integer — Number of replies to the tweet.
  - `retweet_count` integer — Number of retweets.
  - `retweeted_status` CommonTweet — recursive
  - `user` CommonUser
    - `bio_urls` string[] — URLs found in the user's bio.
    - `can_dm` boolean — Whether the account accepts direct messages.
    - `created_at` string — Account creation date in ISO 8601 format.
    - `description` string — Profile bio text.
    - `display_name` string — User's display name.
    - `favourites_count` integer — Total number of tweets this user has liked.
    - `followers_count` integer — Number of accounts following this user.
    - `followings_count` integer — Number of accounts this user follows.
    - `id` string — Unique Twitter/X user ID.
    - `location` string — Location string from the user's profile.
    - `media_count` integer — Total number of media items posted by this user.
    - `pinned_tweet_ids` string[] — IDs of the user's pinned tweets.
    - `possibly_sensitive` boolean — Whether the account is flagged as possibly containing sensitive content.
    - `profile_background_image_url` string — URL of the user's profile background image.
    - `profile_image_url` string — URL of the user's avatar image.
    - `protected` boolean — Whether the account's tweets are protected (private).
    - `tweets_count` integer — Total number of tweets posted by this user.
    - `username` string — Current Twitter/X handle (without @).
    - `verified` boolean — Whether the account has a verified badge.
  - `view_count` integer — Number of views (impressions).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/sorsa/apis/api-sorsa-io.md) · [All operations](https://skmtc.net/sorsa/apis/api-sorsa-io/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sorsa/api-sorsa-io/versions/7742c72d6966/schema)