Skip to content

TwitterPlatformData.md

Latest commit

 

History

History
34 lines (22 loc) · 3.5 KB

TwitterPlatformData.md

File metadata and controls

34 lines (22 loc) · 3.5 KB
Raw

TwitterPlatformData

X (Twitter) geo-restriction applies at the media level. Media in geo-restricted tweets will be hidden for users outside the specified countries; the tweet text itself remains visible globally. Requires media to be attached (ignored for text-only tweets).

Properties

Name Type Description Notes
replyToTweetId String ID of an existing tweet to reply to. The published tweet will appear as a reply in that tweet's thread. For threads, only the first tweet replies to the target; subsequent tweets chain normally. [optional]
quoteTweetId String ID (or full status URL) of an existing tweet to quote-repost. The published tweet becomes a quote tweet of the target. Mutually exclusive with media and poll. X only permits quoting your own posts or posts you are mentioned in / part of the conversation thread of; quoting an arbitrary other account's post is rejected by X. Billed at the standard create rate ($0.015), unlike pasting a tweet URL into the text which is billed at the URL rate ($0.20). For threads, applies to the first tweet only. [optional]
replySettings ReplySettingsEnum Controls who can reply to the tweet. "following" allows only people you follow, "mentionedUsers" allows only mentioned users, "subscribers" allows only subscribers, "verified" allows only verified users. Omit for default (everyone can reply). For threads, applies to the first tweet only. Cannot be combined with replyToTweetId. [optional]
threadItems List<TwitterPlatformDataThreadItemsInner> Complete sequence of tweets in a thread. The first item becomes the root tweet, subsequent items are chained as replies. When threadItems is provided, the top-level content field is used only for display and search purposes, it is NOT published. You must include your first tweet as threadItems[0]. [optional]
poll TwitterPlatformDataPoll [optional]
longVideo Boolean Enable long video uploads (over 140 seconds) using amplify_video media category. Requires the connected X account to have an active X Premium subscription. When true, videos are uploaded with the amplify_video category which supports longer durations (up to 10 minutes via API). When false or omitted, the standard tweet_video category is used (140 second limit). Note that not all Premium accounts have API long-video access, as X may require separate allowlisting. [optional]
geoRestriction GeoRestriction [optional]
paidPartnership Boolean When true, the post is labeled by X as a paid partnership / paid promotion. For threads, applies to the root tweet only. Field availability may depend on your X API access tier. [optional]
madeWithAi Boolean When true, the post is labeled by X as containing AI-generated media. Per X, this label is for AI-generated media, not AI-written text. For threads, applies to the root tweet only. [optional]
sensitiveMedia TwitterPlatformDataSensitiveMedia [optional]

Enum: ReplySettingsEnum

Name Value
FOLLOWING "following"
MENTIONED_USERS "mentionedUsers"
SUBSCRIBERS "subscribers"
VERIFIED "verified"