--- title: "Batch Get Tweets by ID" method: POST path: "/twitter/tweets/lookup" tags: ["Tweets Endpoints"] --- # Batch Get Tweets by ID `POST /twitter/tweets/lookup` ## Request - Base URL: `https://api.twexapi.io` - URL: `https://api.twexapi.io/twitter/tweets/lookup` - Auth: HTTP bearer Retrieve detailed information for multiple Tweets by their IDs. The maximum input quantity is limited by your plan's QPS. To pass larger input quantity limits, upgrade your plan to get higher QPS. ## Request body - string[]: A list of Twitter tweet IDs. Provide multiple times for multiple tweets (e.g., `[2104354931595423762,2108826911359050211]`). ## Response `200` A list of Tweet objects. - GetTweetsByIdResponse - `code` integer: HTTP status code - `msg` string: Response message - `data` TweetModel[], nullable: Tweet data - `tweet_id` string, required: The unique identifier for the Tweet - `is_paid_promotion` boolean, nullable: Indicates whether the content or user is associated with a paid promotion - `text` string, required: The actual text content of the Tweet - `created_at` string, nullable: The date and time the Tweet was created - `created_at_datetime` string, nullable: The ISO 8601 format of the creation date - `bookmark_count` integer, nullable: Number of times the Tweet has been bookmarked - `bookmarked` boolean, nullable: Indicates if the authenticating user has bookmarked this Tweet - `community_note` string, nullable: Community note associated with the Tweet - `edit_tweet_ids` string[]: A list of Tweet IDs for each edit of the Tweet - `editable_until_msecs` string, nullable: Timestamp for when the Tweet is no longer editable - `edits_remaining` string, nullable: Number of edits remaining for the Tweet - `favorite_count` integer, nullable: Number of likes (favorites) for the Tweet - `favorited` boolean, nullable: Indicates if the authenticating user has liked this Tweet - `full_text` string, nullable: The full text of the Tweet, especially for extended tweets - `has_card` boolean, nullable: Indicates if the Tweet has a card attached - `has_community_notes` boolean, nullable: Indicates if the Tweet has community notes - `hashtags` string[]: A list of hashtags mentioned in the Tweet - `cashtags` string[]: A list of cashtags (stock symbols) mentioned in the Tweet - `id` string, nullable: The unique identifier for the Tweet (same as tweet_id) - `in_reply_to` string, nullable: ID of the Tweet this is a reply to - `in_reply_to_user_id` string, nullable: ID of the user this is a reply to - `in_reply_to_screen_name` string, nullable: Screen name of the user this is a reply to - `is_edit_eligible` boolean, nullable: Indicates if the Tweet is eligible for editing - `is_quote_status` boolean, nullable: Indicates if this Tweet is a quote of another Tweet - `quoted_status_id_str` string, nullable: The unique identifier for the Tweet that this is a quote of - `is_translatable` boolean, nullable: Indicates if the Tweet is translatable - `lang` string, nullable: The BCP 47 language identifier for the Tweet's content - `media` MediaModel[]: A list of media objects (photos, videos) attached to the Tweet - `id` string, required: Media ID - `type` string, required: Type of media (e.g., photo, video) - `display_url` string, nullable: URL of the media to display - `expanded_url` string, nullable: Expanded URL for the media - `media_url` string, nullable: Direct URL to the media file - `url` string, nullable: t.co URL for the media - `height` integer, nullable: Height of the media in pixels - `width` integer, nullable: Width of the media in pixels - `features` object, nullable: Features of the media - `original_info` object, nullable: Original information about the media - `sizes` object, nullable: Available sizes of the media - `source_status_id` string, nullable: Source tweet ID if the media is a retweet - `source_user_id` string, nullable: Source user ID if the media is a retweet - `duration_millis` integer, nullable: Duration of the video in milliseconds - `aspect_ratio` integer[], nullable: Aspect ratio of the video - `video_info` object, nullable: Detailed video information - `streams` StreamModel[]: List of available video streams - `url` string, nullable: URL of the video stream - `bitrate` integer, nullable: Bitrate of the video stream in bps - `content_type` string, nullable: Content type of the stream - `place` string, nullable: The location associated with the Tweet - `poll` string, nullable: A poll attached to the Tweet - `possibly_sensitive` boolean, nullable: Indicates if the Tweet may contain sensitive content - `possibly_sensitive_editable` boolean, nullable: Indicates if the sensitive content flag is editable - `quote` TweetModel (recursive) - `quote_count` integer, nullable: Number of times this Tweet has been quoted - `related_tweets` TweetModel[]: A list of related Tweets - `replies` TweetModel[]: A list of replies to this Tweet - `reply_count` integer, nullable: Number of replies to this Tweet - `reply_to` TweetModel (recursive) - `retweet_count` integer, nullable: Number of times this Tweet has been retweeted - `retweeted_tweet` TweetModel (recursive) - `thread` TweetModel[], nullable: The conversation thread ID - `thumbnail_title` string, nullable: Title for the thumbnail in a card - `thumbnail_url` string, nullable: URL for the thumbnail in a card - `urls` string[]: A list of URLs included in the Tweet - `user` UserModel - `id` string, required: User ID - `name` string, required: Display name - `screen_name` string, required: Twitter username - `created_at` string, nullable: Account creation date - `created_at_datetime` string, nullable: Account creation datetime in ISO format - `can_dm` boolean, nullable: Whether the user can be direct messaged - `can_media_tag` boolean, nullable: Whether the user can be tagged in media - `default_profile` boolean, nullable: Whether the user has a default profile - `default_profile_image` boolean, nullable: Whether the user has a default profile image - `description` string, nullable: User's bio description - `description_urls` string[]: List of URLs found in the user's description - `urls` UrlModel[], nullable: List of URLs found in the user's profile - `url` string, required: URL - `expanded_url` string, nullable: Expanded URL - `display_url` string, nullable: Display URL - `fast_followers_count` integer, nullable: Count of fast followers - `favourites_count` integer, nullable: Number of tweets the user has liked - `followers_count` integer, nullable: Number of followers - `following_count` integer, nullable: Number of users this user is following - `has_custom_timelines` boolean, nullable: Whether the user has custom timelines - `is_blue_verified` boolean, nullable: Blue verification status - `verified_type` string, nullable: Verification badge type when not blue-only: blue, business, government, etc. - `is_verified` boolean, nullable: True if the account has any verification badge (blue, business, government, or legacy verified) - `profile_image_shape` string, nullable: Profile image shape (Circle or Square; Square often indicates business/government) - `is_translator` boolean, nullable: Whether the user is a translator - `listed_count` integer, nullable: Number of public lists the user is a member of - `location` string, nullable: User's location - `media_count` integer, nullable: Number of media tweets posted by the user - `normal_followers_count` integer, nullable: Count of normal followers - `pinned_tweet_ids` string[]: List of pinned tweet IDs - `possibly_sensitive` boolean, nullable: Whether the user's profile may contain sensitive content - `profile_banner_url` string, nullable: URL of the user's profile banner - `profile_image_url` string, nullable: URL of the user's profile image - `protected` boolean, nullable: Whether the user's tweets are protected - `statuses_count` integer, nullable: Number of tweets posted by the user - `view_count` string, nullable: Number of views for the Tweet - `view_count_state` string, nullable: State of the view count - `status` object, nullable: Raw status dictionary - `target_count` integer, nullable: The target count of items requested, for context ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/twexapi/apis/twexapi-rest-api.md) · [All operations](https://skmtc.dev/twexapi/apis/twexapi-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twexapi/apis/twexapi-rest-api/revisions/59a99ac0d8f7?raw)