Get Started
User Endpoint
Tweet Endpoint
List Endpoint
Get Tweets by IDs
get tweet by tweet ids
curl --request GET \
--url https://api.twitterapi.io/twitter/tweets \
--header 'X-API-Key: <api-key>'
{
"tweets": [
{
"type": "tweet",
"id": "<string>",
"url": "<string>",
"text": "<string>",
"source": "<string>",
"retweetCount": 123,
"replyCount": 123,
"likeCount": 123,
"quoteCount": 123,
"viewCount": 123,
"createdAt": "<string>",
"lang": "<string>",
"bookmarkCount": 123,
"isReply": true,
"inReplyToId": "<string>",
"conversationId": "<string>",
"inReplyToUserId": "<string>",
"inReplyToUsername": "<string>",
"author": {
"type": "user",
"userName": "<string>",
"url": "<string>",
"id": "<string>",
"name": "<string>",
"isBlueVerified": true,
"profilePicture": "<string>",
"coverPicture": "<string>",
"description": "<string>",
"location": "<string>",
"followers": 123,
"following": 123,
"canDm": true,
"createdAt": "<string>",
"fastFollowersCount": 123,
"favouritesCount": 123,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 123,
"statusesCount": 123,
"withheldInCountries": [
"<string>"
],
"affiliatesHighlightedLabel": {},
"possiblySensitive": true,
"pinnedTweetIds": [
"<string>"
],
"isAutomated": true,
"automatedBy": "<string>",
"unavailable": true,
"message": "<string>",
"unavailableReason": "<string>",
"profile_bio": {
"description": "<string>",
"entities": {
"description": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
},
"url": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
}
}
}
},
"entities": {
"hashtags": [
{
"indices": [
123
],
"text": "<string>"
}
],
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
],
"user_mentions": [
{
"id_str": "<string>",
"name": "<string>",
"screen_name": "<string>"
}
]
},
"quoted_tweet": {},
"retweeted_tweet": {}
}
],
"status": "success",
"message": "<string>"
}
Authorizations
Query Parameters
The tweet ids to get.eg. 1846987139428634858,1866332309399781537,1868244766405870076. Use comma to separate multiple tweet ids
Response
Array of tweets
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
user
The username of the Twitter user
The x.com URL of the user's profile
The unique identifier of the user
The display name of the user
Whether the user has Twitter Blue verification
URL of the user's profile picture
URL of the user's cover picture
The user's profile description
The user's location.for example: 東京の端っこ . may be empty
Number of followers
Number of accounts following
Whether the user can receive DMs
When the account was created.for example: Thu Dec 13 08:41:26 +0000 2007
Number of fast followers
Number of favorites
Whether the user has custom timelines
Whether the user is a translator
Number of media posts
Number of status updates
Countries where the account is withheld
Whether the account may contain sensitive content
IDs of pinned tweets
Whether the account is automated
The account that automated the account
Whether the account is unavailable
The message of the account.eg. "This account is unavailable" or "This account is suspended"
The reason the account is unavailable.eg. "suspended"
The tweet being quoted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
The tweet being retweeted.may be null
tweet
The ID of the tweet
The URL of the tweet
The text of the tweet
The source of the tweet.eg. "Twitter for iPhone"
The number of times the tweet has been retweeted
The number of times the tweet has been replied to
The number of times the tweet has been liked
The number of times the tweet has been quoted
The number of times the tweet has been viewed
The date and time the tweet was created.eg. Tue Dec 10 07:00:30 +0000 2024
The language of the tweet.eg. "en".may be empty
The number of times the tweet has been bookmarked
Indicates if the tweet is a reply
The ID of the tweet being replied to.may be empty
The ID of the conversation the tweet is part of.may be empty
The ID of the user being replied to.may be empty
The username of the user being replied to.may be empty
The user who posted the tweet
The entities in the tweet.eg. hashtags,urls,mentions
The tweet being quoted.may be null
The tweet being retweeted.may be null
Status of the request.success or error
success
, error
Message of the request.error message
curl --request GET \
--url https://api.twitterapi.io/twitter/tweets \
--header 'X-API-Key: <api-key>'
{
"tweets": [
{
"type": "tweet",
"id": "<string>",
"url": "<string>",
"text": "<string>",
"source": "<string>",
"retweetCount": 123,
"replyCount": 123,
"likeCount": 123,
"quoteCount": 123,
"viewCount": 123,
"createdAt": "<string>",
"lang": "<string>",
"bookmarkCount": 123,
"isReply": true,
"inReplyToId": "<string>",
"conversationId": "<string>",
"inReplyToUserId": "<string>",
"inReplyToUsername": "<string>",
"author": {
"type": "user",
"userName": "<string>",
"url": "<string>",
"id": "<string>",
"name": "<string>",
"isBlueVerified": true,
"profilePicture": "<string>",
"coverPicture": "<string>",
"description": "<string>",
"location": "<string>",
"followers": 123,
"following": 123,
"canDm": true,
"createdAt": "<string>",
"fastFollowersCount": 123,
"favouritesCount": 123,
"hasCustomTimelines": true,
"isTranslator": true,
"mediaCount": 123,
"statusesCount": 123,
"withheldInCountries": [
"<string>"
],
"affiliatesHighlightedLabel": {},
"possiblySensitive": true,
"pinnedTweetIds": [
"<string>"
],
"isAutomated": true,
"automatedBy": "<string>",
"unavailable": true,
"message": "<string>",
"unavailableReason": "<string>",
"profile_bio": {
"description": "<string>",
"entities": {
"description": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
},
"url": {
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
]
}
}
}
},
"entities": {
"hashtags": [
{
"indices": [
123
],
"text": "<string>"
}
],
"urls": [
{
"display_url": "<string>",
"expanded_url": "<string>",
"indices": [
123
],
"url": "<string>"
}
],
"user_mentions": [
{
"id_str": "<string>",
"name": "<string>",
"screen_name": "<string>"
}
]
},
"quoted_tweet": {},
"retweeted_tweet": {}
}
],
"status": "success",
"message": "<string>"
}