Tweet Replies API (X Replies)

Get the replies to any tweet on X (Twitter), sorted by relevance, recency, or likes, with full text, authors, and engagement counts. JSON, $0.01 per call.

POST/v1/twitter/tweet-replies

$0.01/call

Returns the replies under a tweet — the conversation X shows on the post page — sorted by relevance (X's default ranking), recency, or likes. The original tweet is not repeated in the list; get it from the Tweet API.

Usage

const res = await fetch('https://api.yepapi.com/v1/twitter/tweet-replies', {
  method: 'POST',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"tweet": "2116173868326846654", "sort": "relevance"}),
});
const { data } = await res.json();
console.log(data);

curl -X POST https://api.yepapi.com/v1/twitter/tweet-replies \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tweet": "2116173868326846654", "sort": "relevance"}'

import requests

res = requests.post(
    "https://api.yepapi.com/v1/twitter/tweet-replies",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"tweet": "2116173868326846654", "sort": "relevance"},
)
print(res.json()["data"])

Request Body

Parameter	Type	Required	Description	Default
`tweet`	`string`	Yes	Tweet ID (`2116173868326846654`) or a post URL (`https://x.com/NASA/status/2116173868326846654`)	—
`sort`	`string`	No	One of: `relevance`, `recency`, `likes`	`relevance`
`count`	`number`	No	Page size hint, 1–100	`20`
`cursor`	`string`	No	`cursor` from the previous response, to fetch the next page	—

Response

{
  "ok": true,
  "data": {
    "cursor": "DAAKCgABHV69Us1__mMLAAIAAAGoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUNVZFhsdnFEdFpoL1IxZUxkMzlHMkhESFY0Njg2OGJzVUFkWG56R1JGY1JtaDFlTVBISlcyQUFIVjV6ZVBiYmNld2RYam1uSTlyZ0ZCMWVNWjZWMTZHNUhWNG82OWlXQUw0ZFhpc3Bq…",
    "tweets": [
      {
        "author": {
          "avatar": "https://pbs.twimg.com/profile_images/1893413015816380416/F27IkH1-_400x400.jpg",
          "banner": "https://pbs.twimg.com/profile_banners/2849146321/1643486766",
          "created_at": "2014-10-09T18:13:12+00:00",
          "description": "Pursuer of truth & preserver of history. Oil and gas connoisseur. Fighting tyranny one post at a time.\n #IStandwithIsrael",
          "followers_count": 2388,
          "following_count": 3990,
          "id": "2849146321",
          "is_blue_verified": true,
          "likes_count": 153470,
          "listed_count": 7,
          "location": "Colorado",
          "media_count": 1095,
          "name": "Kimberly",
          "pinned_tweet_ids": [],
          "protected": false,
          "tweet_count": 30260,
          "url": "https://x.com/Watthehecky",
          "username": "Watthehecky",
          "verified": false,
          "verified_type": null,
          "website": null
        },
        "bookmarks": 0,
        "conversation_id": "2116173868326846654",
        "created_at": "2026-10-30T16:00:10+00:00",
        "hashtags": [],
        "id": "2116198483292270947",
        "in_reply_to_tweet_id": "2116173868326846654",
        "in_reply_to_username": "NASA",
        "is_quote": false,
        "is_retweet": false,
        "lang": "en",
        "likes": 9,
        "media": [],
        "mentions": [
          "NASA"
        ],
        "possibly_sensitive": false,
        "quoted_tweet": null,
        "quotes": 0,
        "replies": 0,
        "retweeted_tweet": null,
        "retweets": 0,
        "text": "@NASA May his memory be a blessing. 🙏❤️🕯",
        "url": "https://x.com/Watthehecky/status/2116198483292270947",
        "urls": [],
        "views": 677
      }
    ]
  }
}

Response Fields

Field	Type	Description
`ok`	`boolean`	Whether the request succeeded
`data.tweets`	`object[]`	Replies
`data.tweets[].id`	`string`	Tweet ID
`data.tweets[].url`	`string`	x.com URL of the tweet
`data.tweets[].text`	`string`	Full text
`data.tweets[].created_at`	`string`	ISO 8601 timestamp
`data.tweets[].lang`	`string \| null`	Language code detected by X
`data.tweets[].author`	`object`	Author profile — same fields as `/v1/twitter/user`
`data.tweets[].likes`	`number`	Like count
`data.tweets[].retweets`	`number`	Repost count
`data.tweets[].replies`	`number`	Reply count
`data.tweets[].quotes`	`number`	Quote count
`data.tweets[].bookmarks`	`number`	Bookmark count
`data.tweets[].views`	`number \| null`	View count
`data.tweets[].conversation_id`	`string`	ID of the thread's first tweet
`data.tweets[].in_reply_to_tweet_id`	`string \| null`	Tweet this one replies to
`data.tweets[].in_reply_to_username`	`string \| null`	Handle this one replies to
`data.tweets[].is_retweet`	`boolean`	This is a repost — the original is in `retweeted_tweet`
`data.tweets[].is_quote`	`boolean`	This quotes another tweet — see `quoted_tweet`
`data.tweets[].possibly_sensitive`	`boolean`	Flagged as sensitive media
`data.tweets[].hashtags`	`string[]`	Hashtags without `#`
`data.tweets[].mentions`	`string[]`	Mentioned handles
`data.tweets[].urls`	`string[]`	Expanded links
`data.tweets[].media`	`object[]`	Photos, videos, GIFs: `type` (`photo`, `video`, `animated_gif`), `url`, `video_url` (MP4), `duration_ms`, `width`, `height`, `alt_text`
`data.tweets[].quoted_tweet`	`object \| null`	The quoted tweet, same shape
`data.tweets[].retweeted_tweet`	`object \| null`	The reposted tweet, same shape
`data.cursor`	`string \| null`	Cursor for the next page

Pagination

Each response includes a cursor. Send the same request again with that value in cursor to get the next page; cursor is null when there is nothing more (or the page came back empty). count is a page-size hint — X may return a few more or fewer items than you ask for. Every page is a separate $0.01 call.

Caching

Responses are cached for 10 minutes.

Errors

Status	Code	When
`400`	`VALIDATION_ERROR`	`tweet` is invalid or `sort` is not an allowed value
`429`	`RATE_LIMITED_UPSTREAM`	Too many requests in a short burst — retry after a few seconds
`502` / `503`	`UPSTREAM_ERROR` / `SERVICE_UNAVAILABLE`	Temporary problem fetching data from X — retry later

Failed calls are not charged.

A tweet with no replies — or one that is deleted or protected — returns 200 with an empty tweets list.

Tweet API — the original tweet
Tweet Quotes — quote tweets
Twitter Search API — conversation_id:<id> searches a whole thread

Tweet Replies API (X Replies)

On this page