X (TWITTER) API

Tweet Replies API

List the replies beneath a tweet, with the threads under each one. Returns the text, author, timestamp and engagement counts for each reply. Page through them with `cursor`.

Endpoint
POST /x/get-tweet-replies
Price
1 credit per result
SDK
client.x.getTweetReplies()
MCP tool
x_get_tweet_replies
Start free with 100 creditsRead docs →
Terminal
curl -X POST "https://api.bridgly.app/x/get-tweet-replies" \
  -H "Authorization: Bearer $BRIDGLY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tweetId": "20"
}'
[ REQUEST AND RESPONSE ]

What does the Tweet Replies API return?

Tweet replies API: list the replies to any tweet on X (Twitter), with the threads beneath them and each reply’s text, author and engagement, as JSON. Every response has the same envelope: the result in data, plus timeMs and the creditsCost of the call.

Request body

tweetIdstringrequired
Numeric ID of the tweet whose replies to list, or the tweet link, e.g. "1234567890".
cursorstring
The previous response's `nextCursor`, to fetch the next page. Omit it for the first page.
sortOrderenum
Reply ordering: "Relevance" for X's ranking (default), "Recency" for newest first, "Likes" for most liked first.
Relevance | Recency | Likes

Example response

200 OK · application/json
{
  "timeMs": 1840,
  "creditsCost": 1,
  "data": {
    "replies": [
      {
        "id": "string",
        "url": "string",
        "text": "string",
        "author": {
          "userId": "string",
          "username": "string",
          "profileUrl": "string",
          "displayName": "string",
          "bio": "string",
          "avatarUrl": "string",
          "bannerUrl": "string",
          "location": "string",
          "followerCount": 0,
          "followingCount": 0,
          "tweetCount": 0,
          "mediaCount": 0,
          "likeCount": 0,
          "listedCount": 0,
          "pinnedTweetId": "string",
          "pinnedTweetUrl": "string",
          "createdAt": "2026-01-15T09:30:00.000Z",
          "createdAtEpochMs": 0,
          "isVerified": true,
          "isBlueVerified": true
        },
        "createdAt": "2026-01-15T09:30:00.000Z",
        "createdAtEpochMs": 0,
        "source": "string",
        "conversationId": "string",
        "replyCount": 0,
        "retweetCount": 0,
        "likeCount": 0,
        "quoteCount": 0,
        "bookmarkCount": 0,
        "viewCount": 0,
        "replyToTweetId": "string",
        "replyToUserId": "string",
        "replyToUsername": "string",
        "replyToTweetUrl": "string",
        "isQuote": true,
        "quotedTweetId": "string",
        "quotedTweetUrl": "string",
        "quotedTweetAuthorId": "string",
        "quotedTweetAuthorUsername": "string",
        "retweetedTweetId": "string",
        "retweetedTweetUrl": "string",
        "retweetedTweetAuthorId": "string",
        "retweetedTweetAuthorUsername": "string",
        "lang": "string",
        "isSensitive": true,
        "hashtags": [
          "string"
        ],
        "mentions": [
          {
            "userId": "string",
            "username": "string",
            "displayName": "string",
            "profileUrl": "string"
          }
        ],
        "urls": [
          {
            "shortUrl": "string",
            "expandedUrl": "string",
            "displayUrl": "string"
          }
        ],
        "media": [
          {
            "type": "photo",
            "url": "string",
            "mediaKey": "string",
            "mediaId": "string",
            "width": 0,
            "height": 0,
            "expandedUrl": "string",
            "videoUrl": "string",
            "durationMs": 0
          }
        ]
      }
    ],
    "nextCursor": "string"
  }
}
[ USE CASES ]

What can you build with the Tweet Replies API?

Read the reaction

Collect every reply to a launch or announcement.

Answer questions

Find replies asking for help and respond to them.

Judge sentiment

Send reply texts to a model to see how a post landed.

[ FAQ ]

Tweet Replies API questions

How do I get all the replies to a tweet?

Send the tweet ID, the number after /status/ in its link. Each call returns a page of replies and a nextCursor; send it back as cursor to get the next page. It is null once there are no more.

How many replies does each call return?

X decides the page size, usually a few dozen replies including the threads beneath them. You pay 1 credit per reply returned.

How do I use the Tweet Replies API?

Send a POST request to https://api.bridgly.app/x/get-tweet-replies with tweetId in the JSON body and your API key in the Authorization header. In the TypeScript SDK, call client.x.getTweetReplies(). AI agents connected to Bridgly over MCP can call the x_get_tweet_replies tool.

How much does the Tweet Replies API cost?

Costs 1 credit per result returned, with a minimum of 1 credit per request. Credits cost $2.00 per 1,000 on pay-as-you-go and as low as $1.00 per 1,000 at volume. New accounts on a business email start with 100 free credits, and failed requests are never charged.

[ MORE ENDPOINTS ]

More X (Twitter) endpoints

The same API key works on every endpoint. See all X (Twitter) API endpoints.

Try the Tweet Replies API

100 free credits on business email, no card. Your first call takes a minute.

APIMCPSDKCLI
free credits

On business email signup. No credit card required.

Start free with 100 credits
Book a demoRead the docs