Social Fetch
Twitter

List Twitter tweet replies

List replies to a tweet.

GET/v1/twitter/tweets/replies
2credits
x-api-key*stringheader

API key (`sfk_...`)

Parameters
2
url*stringquery

Tweet permalink or identifier.

min 1 chars · max 4096 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

Response fields
45

Endpoint-specific response payload.

Reply posts returned for the requested tweet.

datareplies[]id
string

Tweet id.

min 1 chars

datareplies[]url
stringnullable

Canonical public URL for the tweet when available.

datareplies[]text
string

Full tweet text when available.

datareplies[]createdAt
integer

Creation time as Unix epoch seconds.

≥ 0

datareplies[]createdAtLabel
stringnullable

Human-readable creation timestamp string when available.

datareplies[]language
stringnullable

Language code for the tweet when available.

datareplies[]conversationId
stringnullable

Conversation identifier when supplied.

min 1 chars

datareplies[]inReplyToStatusId
stringnullable

Parent post identifier when this post is a reply.

min 1 chars

datareplies[]quotedStatusId
stringnullable

Quoted post identifier when this post quotes another.

min 1 chars

datareplies[]retweetTweetId
stringnullable

Original post identifier when this post is an engagement repost.

min 1 chars

Author metadata for the tweet when available.

datareplies[]authorhandle
string

Author handle without the leading @.

min 1 chars

datareplies[]authordisplayName
stringnullable

Display name shown for the author.

datareplies[]authoravatarUrl
stringnullable

Profile image URL for the author when available.

datareplies[]authorprofileUrl
stringnullable

Canonical public profile URL for the author when available.

datareplies[]authorverified
boolean

Whether the author has legacy verification on X.

datareplies[]authorblueVerified
boolean

Whether the author has paid blue verification on X.

datareplies[]authorplatformUserId
stringoptional

Numeric X user id for the author as a string.

Engagement metrics for a tweet.

datareplies[]metricslikes
integer

Like count.

≥ 0

datareplies[]metricsretweets
integer

Retweet count.

≥ 0

datareplies[]metricsreplies
integer

Reply count.

≥ 0

datareplies[]metricsquotes
integer

Quote count.

≥ 0

datareplies[]metricsviews
integernullable

View count when available.

≥ 0

datareplies[]metricsbookmarkCount
integernullable

Bookmark count when available.

≥ 0

Media attachments returned for the tweet.

datareplies[]media[]url
string

Direct media URL when available.

min 1 chars

datareplies[]media[]type
string

Media type when Social Fetch can classify it confidently.

one of: photo, video

datareplies[]media[]thumbnailUrl
stringoptional

Poster or thumbnail URL for video media when distinguishable.

min 1 chars

datareplies[]media[]contentType
stringoptional

MIME type reported for streamed media.

min 1 chars

datareplies[]media[]bitrate
integeroptional

Bitrate in bits per second when supplied for streamed media.

≥ 0

datareplies[]media[]width
integeroptional

Width in pixels when available.

≥ 0

datareplies[]media[]height
integeroptional

Height in pixels when available.

≥ 0

datareplies[]expandedUrl
stringnullable

Expanded URL attached to the tweet when available.

datareplies[]isRetweet
boolean

Whether the tweet is marked as a retweet.

datareplies[]source
stringnullable

Source label such as `Twitter Web App` when available.

Pagination information for the current response.

datapagenextCursor
stringnullable

Cursor to pass as `cursor` in the next request when another page exists.

datapagehasMore
boolean

Whether another page can be requested.

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

Code example

curl "https://api.socialfetch.dev/v1/twitter/tweets/replies?url=https://x.com/elonmusk/status/2044990537145753894" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Reply posts for the requested tweet.

On this page

No Headings