This API exposes
9 operations
across 8 paths,
and defines 73 schemas.
It is described by OpenAPI 3.2.0, at version 2.161.
Requests are made against a single base URL, https://api.x.com.
The identity and technical contract details declared by the specification.
DmEventId
string
Unique identifier of a DM Event.
UserName
string
The X handle (screen name) of this user.
NextToken
string
The next token.
CountryCode
string
A two-letter ISO 3166-1 alpha-2 country code.
EntityIndicesInclusiveExclusive
object
Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). start must be smaller than end. The start index…
2 properties
2 required
DmConversationId
string
Unique identifier of a DM conversation. This can either be a numeric string, or a pair of numeric strings separated by a '-' character in the case of one-on-on…
User
object
The X User object.
21 properties
3 required
UrlEntityDm
Represent the portion of text recognized as a URL, and its start and end position within the text.
Get2DmEventsEventIdResponse
object
3 properties
HttpStatusCode
integer
HTTP Status Code.
PollOption
object
Describes a choice in a Poll object.
3 properties
3 required
DmMediaAttachment
object
1 property
1 required
CommunityId
string
The unique identifier of this Community.
CreateDmEventResponse
object
2 properties
PlaceId
string
The identifier for this place.
PreviousToken
string
The previous token.
NoteTweetText
string
The note content of the Tweet.
Get2DmEventsResponse
object
4 properties
ContextAnnotationDomainFields
object
Represents the data for the context annotation domain.
3 properties
1 required
DisplayTextRange
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 i…
CreateDmConversationRequest
object
3 properties
3 required
CreateTextMessageRequest
object
2 properties
1 required
EntityIndicesInclusiveInclusive
object
Represent a boundary range (start and end index) for a recognized entity (for example a hashtag or a mention). start must be smaller than end. The start index…
2 properties
2 required
Error
object
2 properties
2 required
TweetWithheld
object
Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).
3 properties
2 required
MediaHeight
integer
The height of the media in pixels.
ResultCount
integer
The number of results returned in this response.
FullTextEntities
object
5 properties
ReplySettingsWithVerifiedUsers
string
Shows who can reply a Tweet. Fields returned are everyone, mentionedusers, subscribers, verified and following.
PaginationToken32
string
A base32 pagination token.
BinaryPayload
string
Raw binary data bytes.
MediaKey
string
The Media Key identifier for this attachment.
PollOptionLabel
string
The text of a poll choice.
DeleteDmResponse
object
2 properties
CashtagFields
object
Represent the portion of text recognized as a Cashtag, and its start and end position within the text.
1 property
1 required
MentionFields
object
Represent the portion of text recognized as a User mention, and its start and end position within the text.
2 properties
1 required
Get2DmConversationsIdDmEventsResponse
object
4 properties
ContextAnnotationEntityFields
object
Represents the data for the context annotation entity.
3 properties
1 required
HashtagFields
object
Represent the portion of text recognized as a Hashtag, and its start and end position within the text.
1 property
1 required
MediaId
string
The unique identifier of this Media.
Position
array
A [GeoJson Position](https://tools.ietf.org/html/rfc7946section-3.1.1) in the format [longitude,latitude].
Expansions
object
6 properties
TopicId
string
Unique identifier of this Topic.
MediaWidth
integer
The width of the media in pixels.
Place
object
8 properties
2 required
DmParticipants
array
Participants for the DM Conversation.
UrlFields
object
Represent the portion of text recognized as a URL.
9 properties
1 required
UserWithheld
object
Indicates withholding details for [withheld content](https://help.twitter.com/en/rules-and-policies/tweet-withheld-by-country).
2 properties
1 required
Topic
object
The topic of a Space, as selected by its creator.
3 properties
2 required
UserId
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.
CreateAttachmentsMessageRequest
object
2 properties
1 required
Media
object
4 properties
1 required
ContextAnnotation
object
Annotation inferred from the Tweet text.
2 properties
2 required
TweetId
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.
Url
string
A validly formatted URL.
UrlImage
object
Represent the information for the URL image.
3 properties
Point
object
A [GeoJson Point](https://tools.ietf.org/html/rfc7946section-3.1.2) geometry object.
2 properties
2 required
Poll
object
Represent a Poll attached to a Tweet.
5 properties
2 required
Geo
object
4 properties
3 required
Get2DmConversationsWithParticipantIdDmEventsResponse
object
4 properties
DmResourceId
string
The resource identifier of the media file, including file extension.
Problem
object
An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).
4 properties
2 required
DmAttachments
array
Attachments to a DM Event.
DmEvent
object
13 properties
2 required
TweetText
string
The content of the Tweet.
PollId
string
Unique identifier of this poll.
UrlEntity
Represent the portion of text recognized as a URL, and its start and end position within the text.
Tweet
object
29 properties
The full machine-readable OpenAPI contract behind this narrative.
