X (Twitter) · Schema

Tweet

Tweet schema from X API v2

Social MediaMicrobloggingReal-Time DataStreamingAdvertisingContent

Properties

Name Type Description
attachments object Specifies the type of attachments (if any) present in this Tweet.
author_id string Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
community_id string The unique identifier of this Community.
context_annotations array
conversation_id string Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
created_at string Creation time of the Tweet.
display_text_range array Represent a boundary range (start and end zero-based indices) for the portion of text that is displayed for a post. `start` must be smaller than `end`. The start index is inclusive, the end index is e
edit_controls object
edit_history_tweet_ids array A list of Tweet Ids in this Tweet chain.
entities object
geo object The location tagged on the Tweet, if the user provided one.
id string Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
in_reply_to_user_id string Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
lang string Language of the Tweet, if detected by X. Returned as a BCP47 language tag.
non_public_metrics object Nonpublic engagement metrics for the Tweet at the time of the request.
note_tweet object The full-content of the Tweet, including text beyond 280 characters.
organic_metrics object Organic nonpublic engagement metrics for the Tweet at the time of the request.
possibly_sensitive boolean Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.
promoted_metrics object Promoted nonpublic engagement metrics for the Tweet at the time of the request.
public_metrics object Engagement metrics for the Tweet at the time of the request.
referenced_tweets array A list of Posts this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.
reply_settings string Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, subscribers, verified and following.
scopes object The scopes for this tweet
source string This is deprecated.
suggested_source_links array
suggested_source_links_with_counts object Suggested source links and the number of requests that included each link.
text string The content of the Tweet.
username string The X handle (screen name) of this user.
withheld object Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).
View JSON Schema on GitHub