Get multiple tweets

GET/v1/twitter/tweets/batch

1credit

Headers

Get your API key

x-api-keystringheader

API key (`sfk_...`)

Parameters

urlarrayrequiredquery

Tweet permalink or numeric id. Repeat `url` for each tweet (max 200).

Response fields

211

Endpoint-specific response payload.

Per-input tweet lookup results, in request order.

dataresults[]input

string

Requested tweet id or permalink, echoed as sent.

min 1 chars

dataresults[]tweetId

string

Numeric tweet id parsed from `input`.

min 1 chars

dataresults[]lookupStatus

string

Whether this tweet was found.

one of: found, not_found

Tweet details when found; null when not found.

dataresults[]tweetid

string

Tweet id.

min 1 chars

dataresults[]tweeturl

string

Canonical public URL for this tweet on x.com.

min 1 chars

dataresults[]tweetconversationId

string

Conversation root tweet id.

min 1 chars

dataresults[]tweetcreatedAt

string

Creation time (ISO-8601).

dataresults[]tweetlanguage

string

BCP 47 or X language code.

min 1 chars

dataresults[]tweettext

string

Full tweet text (includes long-form when available).

dataresults[]tweetisLongForm

boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

dataresults[]tweetdisplayTextRange[]

integeroptional

≥ 0

Engagement metrics for a tweet.

dataresults[]tweetmetricsviews

integer

Impression count when reported by X.

≥ 0

dataresults[]tweetmetricsfavorites

integer

Favorite (like) count.

≥ 0

dataresults[]tweetmetricsretweets

integer

Native repost count.

≥ 0

dataresults[]tweetmetricsreplies

integer

Reply count.

≥ 0

dataresults[]tweetmetricsbookmarks

integer

Bookmark count.

≥ 0

dataresults[]tweetmetricsquotes

integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

dataresults[]tweetmedia[]

optional

Entities aligned with `text`.

Hashtag entities.

dataresults[]tweetentitieshashtags[]text

string

Hashtag text without #.

User mention entities.

dataresults[]tweetentitiesuserMentions[]handle

string

Mentioned screen name.

min 1 chars

dataresults[]tweetentitiesuserMentions[]displayName

stringoptional

Display name when available.

dataresults[]tweetentitiesuserMentions[]platformUserId

stringoptional

Numeric user id for the mention when available.

URL entities.

dataresults[]tweetentitiesurls[]url

string

Short URL as it appears in text.

min 1 chars

dataresults[]tweetentitiesurls[]displayUrl

string

Human-readable display host/path.

min 1 chars

dataresults[]tweetentitiesurls[]expandedUrl

string

Fully expanded destination URL.

min 1 chars

Symbol entities.

dataresults[]tweetentitiessymbols[]text

string

Cashtag or symbol text.

min 1 chars

dataresults[]tweetisReply

boolean

Whether this is a reply.

dataresults[]tweetinReplyToTweetId

stringoptional

Parent tweet id when replying.

dataresults[]tweetinReplyToUserId

stringoptional

Parent author user id when replying.

dataresults[]tweetinReplyToScreenName

stringoptional

Parent author handle when replying.

dataresults[]tweetisQuote

boolean

Whether this tweet quotes another.

dataresults[]tweetquotedTweetId

stringoptional

Quoted tweet id when present.

dataresults[]tweetisRetweet

boolean

Whether this is a native repost.

dataresults[]tweetretweetedTweetId

stringoptional

Original tweet id for a repost.

dataresults[]tweetpossiblySensitive

boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

dataresults[]tweeteditInfoeditTweetIds[]

stringoptional

min 1 chars

dataresults[]tweeteditInfoeditableUntilMsec

string

Epoch milliseconds until edits are locked.

dataresults[]tweeteditInfoisEditEligible

boolean

Whether the tweet can still be edited.

dataresults[]tweeteditInfoeditsRemaining

string

Remaining edits in the window, as reported by X.

dataresults[]tweetsource

stringoptional

Client label text.

dataresults[]tweetsourceUrl

stringoptional

Link target from the source anchor when present.

dataresults[]tweetcommunityId

stringnullable

Community id when the tweet was posted to a community.

dataresults[]tweethasAIGeneratedMedia

booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

dataresults[]tweetisPaidPromotion

booleannullableoptional

Whether X marks the tweet as a paid promotion.

dataresults[]tweetisTranslatable

booleannullableoptional

Whether X considers the tweet text translatable.

dataresults[]tweethasBirdwatchNotes

booleannullableoptional

Whether Community Notes are attached to this tweet.

Quoted tweet expanded one level (no further nesting on this field). Null when this is not a quote.

dataresults[]tweetquotedTweetid

string

Tweet id.

min 1 chars

dataresults[]tweetquotedTweeturl

string

Canonical public URL for this tweet on x.com.

min 1 chars

dataresults[]tweetquotedTweetconversationId

string

Conversation root tweet id.

min 1 chars

dataresults[]tweetquotedTweetcreatedAt

string

Creation time (ISO-8601).

dataresults[]tweetquotedTweetlanguage

string

BCP 47 or X language code.

min 1 chars

dataresults[]tweetquotedTweettext

string

Full tweet text (includes long-form when available).

dataresults[]tweetquotedTweetisLongForm

boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

dataresults[]tweetquotedTweetdisplayTextRange[]

integeroptional

≥ 0

Author snapshot when available.

dataresults[]tweetquotedTweetauthorhandle

string

Author screen name without the leading @.

min 1 chars

dataresults[]tweetquotedTweetauthordisplayName

stringnullable

Author display name.

dataresults[]tweetquotedTweetauthoravatarUrl

stringnullable

Best available square avatar URL for the author.

dataresults[]tweetquotedTweetauthorverified

boolean

Whether X marks the author with legacy verification.

dataresults[]tweetquotedTweetauthorblueVerified

boolean

Whether the author has X blue (paid) verification.

dataresults[]tweetquotedTweetauthorplatformUserId

stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

dataresults[]tweetquotedTweetmetricsviews

integer

Impression count when reported by X.

≥ 0

dataresults[]tweetquotedTweetmetricsfavorites

integer

Favorite (like) count.

≥ 0

dataresults[]tweetquotedTweetmetricsretweets

integer

Native repost count.

≥ 0

dataresults[]tweetquotedTweetmetricsreplies

integer

Reply count.

≥ 0

dataresults[]tweetquotedTweetmetricsbookmarks

integer

Bookmark count.

≥ 0

dataresults[]tweetquotedTweetmetricsquotes

integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

dataresults[]tweetquotedTweetmedia[]

optional

Entities aligned with `text`.

Hashtag entities.

dataresults[]tweetquotedTweetentitieshashtags[]text

string

Hashtag text without #.

User mention entities.

dataresults[]tweetquotedTweetentitiesuserMentions[]handle

string

Mentioned screen name.

min 1 chars

dataresults[]tweetquotedTweetentitiesuserMentions[]displayName

stringoptional

Display name when available.

dataresults[]tweetquotedTweetentitiesuserMentions[]platformUserId

stringoptional

Numeric user id for the mention when available.

URL entities.

dataresults[]tweetquotedTweetentitiesurls[]url

string

Short URL as it appears in text.

min 1 chars

dataresults[]tweetquotedTweetentitiesurls[]displayUrl

string

Human-readable display host/path.

min 1 chars

dataresults[]tweetquotedTweetentitiesurls[]expandedUrl

string

Fully expanded destination URL.

min 1 chars

Symbol entities.

dataresults[]tweetquotedTweetentitiessymbols[]text

string

Cashtag or symbol text.

min 1 chars

dataresults[]tweetquotedTweetisReply

boolean

Whether this is a reply.

dataresults[]tweetquotedTweetinReplyToTweetId

stringoptional

Parent tweet id when replying.

dataresults[]tweetquotedTweetinReplyToUserId

stringoptional

Parent author user id when replying.

dataresults[]tweetquotedTweetinReplyToScreenName

stringoptional

Parent author handle when replying.

dataresults[]tweetquotedTweetisQuote

boolean

Whether this tweet quotes another.

dataresults[]tweetquotedTweetquotedTweetId

stringoptional

Quoted tweet id when present.

dataresults[]tweetquotedTweetisRetweet

boolean

Whether this is a native repost.

dataresults[]tweetquotedTweetretweetedTweetId

stringoptional

Original tweet id for a repost.

dataresults[]tweetquotedTweetpossiblySensitive

boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

dataresults[]tweetquotedTweeteditInfoeditTweetIds[]

stringoptional

min 1 chars

dataresults[]tweetquotedTweeteditInfoeditableUntilMsec

string

Epoch milliseconds until edits are locked.

dataresults[]tweetquotedTweeteditInfoisEditEligible

boolean

Whether the tweet can still be edited.

dataresults[]tweetquotedTweeteditInfoeditsRemaining

string

Remaining edits in the window, as reported by X.

dataresults[]tweetquotedTweetsource

stringoptional

Client label text.

dataresults[]tweetquotedTweetsourceUrl

stringoptional

Link target from the source anchor when present.

dataresults[]tweetquotedTweetcommunityId

stringnullableoptional

Community id when the tweet was posted to a community.

dataresults[]tweetquotedTweethasAIGeneratedMedia

booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

dataresults[]tweetquotedTweetisPaidPromotion

booleannullableoptional

Whether X marks the tweet as a paid promotion.

dataresults[]tweetquotedTweetisTranslatable

booleannullableoptional

Whether X considers the tweet text translatable.

dataresults[]tweetquotedTweethasBirdwatchNotes

booleannullableoptional

Whether Community Notes are attached to this tweet.

Reposted tweet expanded one level (no further nesting on this field). Null when this is not a repost.

dataresults[]tweetretweetedTweetid

string

Tweet id.

min 1 chars

dataresults[]tweetretweetedTweeturl

string

Canonical public URL for this tweet on x.com.

min 1 chars

dataresults[]tweetretweetedTweetconversationId

string

Conversation root tweet id.

min 1 chars

dataresults[]tweetretweetedTweetcreatedAt

string

Creation time (ISO-8601).

dataresults[]tweetretweetedTweetcreatedAtUnix

integer

Legacy Unix epoch seconds for tweet creation. Prefer createdAt.

≥ 0

dataresults[]tweetretweetedTweetlanguage

string

BCP 47 or X language code.

min 1 chars

dataresults[]tweetretweetedTweettext

string

Full tweet text (includes long-form when available).

dataresults[]tweetretweetedTweetisLongForm

boolean

True when text was taken from note_tweet metadata instead of legacy.full_text alone.

Start/end character indices for visible text.

dataresults[]tweetretweetedTweetdisplayTextRange[]

integeroptional

≥ 0

Author snapshot when available.

dataresults[]tweetretweetedTweetauthorhandle

string

Author screen name without the leading @.

min 1 chars

dataresults[]tweetretweetedTweetauthordisplayName

stringnullable

Author display name.

dataresults[]tweetretweetedTweetauthoravatarUrl

stringnullable

Best available square avatar URL for the author.

dataresults[]tweetretweetedTweetauthorverified

boolean

Whether X marks the author with legacy verification.

dataresults[]tweetretweetedTweetauthorblueVerified

boolean

Whether the author has X blue (paid) verification.

dataresults[]tweetretweetedTweetauthorplatformUserId

stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

dataresults[]tweetretweetedTweetmetricsviews

integer

Impression count when reported by X.

≥ 0

dataresults[]tweetretweetedTweetmetricsfavorites

integer

Favorite (like) count.

≥ 0

dataresults[]tweetretweetedTweetmetricsretweets

integer

Native repost count.

≥ 0

dataresults[]tweetretweetedTweetmetricsreplies

integer

Reply count.

≥ 0

dataresults[]tweetretweetedTweetmetricsbookmarks

integer

Bookmark count.

≥ 0

dataresults[]tweetretweetedTweetmetricsquotes

integer

Quote tweet count.

≥ 0

Photo, video, or GIF attachments.

dataresults[]tweetretweetedTweetmedia[]

optional

Entities aligned with `text`.

Hashtag entities.

dataresults[]tweetretweetedTweetentitieshashtags[]text

string

Hashtag text without #.

User mention entities.

dataresults[]tweetretweetedTweetentitiesuserMentions[]handle

string

Mentioned screen name.

min 1 chars

dataresults[]tweetretweetedTweetentitiesuserMentions[]displayName

stringoptional

Display name when available.

dataresults[]tweetretweetedTweetentitiesuserMentions[]platformUserId

stringoptional

Numeric user id for the mention when available.

URL entities.

dataresults[]tweetretweetedTweetentitiesurls[]url

string

Short URL as it appears in text.

min 1 chars

dataresults[]tweetretweetedTweetentitiesurls[]displayUrl

string

Human-readable display host/path.

min 1 chars

dataresults[]tweetretweetedTweetentitiesurls[]expandedUrl

string

Fully expanded destination URL.

min 1 chars

Symbol entities.

dataresults[]tweetretweetedTweetentitiessymbols[]text

string

Cashtag or symbol text.

min 1 chars

dataresults[]tweetretweetedTweetisReply

boolean

Whether this is a reply.

dataresults[]tweetretweetedTweetinReplyToTweetId

stringoptional

Parent tweet id when replying.

dataresults[]tweetretweetedTweetinReplyToUserId

stringoptional

Parent author user id when replying.

dataresults[]tweetretweetedTweetinReplyToScreenName

stringoptional

Parent author handle when replying.

dataresults[]tweetretweetedTweetisQuote

boolean

Whether this tweet quotes another.

dataresults[]tweetretweetedTweetquotedTweetId

stringoptional

Quoted tweet id when present.

dataresults[]tweetretweetedTweetisRetweet

boolean

Whether this is a native repost.

dataresults[]tweetretweetedTweetretweetedTweetId

stringoptional

Original tweet id for a repost.

dataresults[]tweetretweetedTweetpossiblySensitive

boolean

Whether X marks the content sensitive.

Edit metadata when applicable.

Tweet ids in this edit chain.

dataresults[]tweetretweetedTweeteditInfoeditTweetIds[]

stringoptional

min 1 chars

dataresults[]tweetretweetedTweeteditInfoeditableUntilMsec

string

Epoch milliseconds until edits are locked.

dataresults[]tweetretweetedTweeteditInfoisEditEligible

boolean

Whether the tweet can still be edited.

dataresults[]tweetretweetedTweeteditInfoeditsRemaining

string

Remaining edits in the window, as reported by X.

dataresults[]tweetretweetedTweetsource

stringoptional

Client label text.

dataresults[]tweetretweetedTweetsourceUrl

stringoptional

Link target from the source anchor when present.

dataresults[]tweetretweetedTweetcommunityId

stringnullableoptional

Community id when the tweet was posted to a community.

dataresults[]tweetretweetedTweethasAIGeneratedMedia

booleannullableoptional

Whether X marks the tweet as containing AI-generated media.

dataresults[]tweetretweetedTweetisPaidPromotion

booleannullableoptional

Whether X marks the tweet as a paid promotion.

dataresults[]tweetretweetedTweetisTranslatable

booleannullableoptional

Whether X considers the tweet text translatable.

dataresults[]tweetretweetedTweethasBirdwatchNotes

booleannullableoptional

Whether Community Notes are attached to this tweet.

dataresults[]tweettype

stringnullable

Tweet kind: `tweet`, `reply`, `quote`, or `retweet`.

Parent tweet when this is a reply.

dataresults[]tweetreplyTotweetId

stringnullable

Parent tweet id.

dataresults[]tweetreplyTouserId

stringnullable

Parent author user id.

dataresults[]tweetreplyTousername

stringnullable

Parent author handle.

Poll when the tweet contains one.

dataresults[]tweetpollid

stringnullable

Poll id.

Poll choices.

dataresults[]tweetpolloptions[]id

stringnullable

Poll choice id.

dataresults[]tweetpolloptions[]label

stringnullable

Poll choice label.

dataresults[]tweetpolloptions[]voteCount

integernullable

Votes for this choice.

≥ 0

dataresults[]tweetpolloptions[]percentage

integernullable

Share of votes for this choice, as a whole percent.

≥ 0

dataresults[]tweetpollendDatetime

stringnullable

When voting ends, as reported by X.

dataresults[]tweetpolldurationMinutes

integernullable

Configured poll duration in minutes.

≥ 0

dataresults[]tweetpollvotingStatus

stringnullable

Poll voting status (for example `closed`).

dataresults[]tweetpolltotalVotes

integernullable

Total votes across all choices.

≥ 0

Article title and preview when present.

dataresults[]tweetarticletitle

stringnullable

Article title.

dataresults[]tweetarticlepreviewText

stringnullable

Short preview of the article body.

dataresults[]tweetisEdited

booleannullable

Whether the tweet has been edited.

Summary counts for the tweet batch.

datasummaryrequested

integer

Number of tweet ids requested in this batch.

≥ 0

datasummaryfound

integer

Number of tweets successfully found.

≥ 0

datasummarynotFound

integer

Number of tweets that were not found.

≥ 0

Metadata describing the request and billing outcome.

metarequestId

string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged

integer

Credits charged for this request.

≥ 0

metaversion

string

Public API version that served the response.

one of: v1

metacached

booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Headers

Code example

Responses