Skip to content
RelayXRelayX API

Get tweet replies (v2)

GET
/twitter/tweet/replies/v2
const url = 'https://api.relayxapi.com/twitter/tweet/replies/v2?tweetId=example';
const options = {
  method: 'GET',
  headers: { 'X-API-Key': '<api-key>' },
};


try {
  const res = await fetch(url, options);
  const data = await res.json();
  console.log(data);
} catch (err) {
  console.error(err);
}

Replies to a post using the newer timeline shape, which preserves conversation threading more faithfully.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
tweetId
required
Tweetid
string
cursor
Cursor
string
queryType
Querytype
string
default: Relevance

Header Parameters

Section titled “Header Parameters”
x-api-key
X-Api-Key
string

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful Response

Media typeapplication/json
Example
{
  "tweets": [
    {
      "type": "tweet",
      "id": "2103243305685225779",
      "url": "https://x.com/i/status/2103243305685225779",
      "text": "Welcome to the Artemis Accords, Côte d'Ivoire 🇨🇮\n \nCôte d'Ivoire is the 75th country to sign the Artemis Accords. In doing so, they commit to a common set of principles for a safe, peaceful, and prosperous future in space. https://t.co/lT9f9Kooo2 https://t.co/9Wf1T1ndGz",
      "retweetCount": 281,
      "replyCount": 109,
      "likeCount": 2490,
      "quoteCount": 24,
      "viewCount": "665904",
      "bookmarkCount": 190,
      "createdAt": "Thu Sep 24 22:00:55 +0000 2026",
      "lang": "en",
      "isReply": false,
      "inReplyToId": null,
      "conversationId": null,
      "displayTextRange": [
        0,
        246
      ],
      "entities": {
        "hashtags": [],
        "symbols": [],
        "urls": [
          {
            "display_url": "go.nasa.gov/3V1mgyS",
            "expanded_url": "https://go.nasa.gov/3V1mgyS",
            "indices": [
              223,
              246
            ],
            "url": "https://t.co/lT9f9Kooo2"
          }
        ],
        "user_mentions": [],
        "media": [
          {
            "display_url": "pic.x.com/9Wf1T1ndGz",
            "expanded_url": "https://x.com/NASA/status/2103243305685225779/photo/1",
            "features": {},
            "id_str": "2103243297779003393",
            "indices": [
              247,
              270
            ],
            "media_results": {
              "id": "QXBpTWVkaWFSZXN1bHRzOgwAAQoAAR0wOKLIVrABCgACHTA4pJ+WETMAAA==",
              "result": {
                "__typename": "ApiMedia",
                "id": "QXBpTWVkaWE6DAABCgABHTA4oshWsAEKAAIdMDikn5YRMwAA",
                "media_availability_v2": {
                  "status": "Available"
                },
                "media_id": "2103243297779003393",
                "media_info": {
                  "__typename": "ApiImage",
                  "alt_text": "A graphic featuring the names and flags of the countries which have signed the Artemis Accords. \"ARTEMIS ACCORDS\" is written at the top.",
                  "color_info": {
                    "palette": [
                      {
                        "percentage": 71.19,
                        "rgb": {
                          "blue": 22,
                          "green": 11,
                          "red": 4
                        }
                      },
                      {
                        "percentage": 3.19,
                        "rgb": {
                          "blue": 215,
                          "green": 209,
                          "red": 211
                        }
                      }
                    ]
                  },
                  "original_img_height": 3375,
                  "original_img_url": "https://pbs.twimg.com/media/HTA4oshWsAEdzZL.jpg",
                  "original_img_width": 6000
                }
              }
            },
            "url": "https://t.co/9Wf1T1ndGz"
          }
        ]
      },
      "quoted_tweet": null,
      "author": {
        "type": "user",
        "userName": "NASA",
        "url": "https://x.com/NASA",
        "id": "11348282",
        "name": "NASA",
        "isBlueVerified": true,
        "description": "Making the seemingly impossible, possible. ✨",
        "location": null,
        "followers": 92374422,
        "following": 117,
        "statusesCount": null,
        "createdAt": "Wed Dec 19 20:20:32 +0000 2007",
        "profilePicture": "https://pbs.twimg.com/profile_images/1321163587679784960/0ZxKlEKB_normal.jpg",
        "coverPicture": "https://pbs.twimg.com/profile_banners/11348282/1788992290",
        "canDm": false,
        "pinnedTweetIds": [],
        "profile_bio": {
          "description": "Making the seemingly impossible, possible. ✨",
          "entities": {
            "description": {}
          }
        }
      }
    },
    {
      "type": "tweet",
      "id": "1900000000000000005",
      "url": "https://x.com/i/status/1900000000000000005",
      "text": "Example post text.",
      "retweetCount": 0,
      "replyCount": 0,
      "likeCount": 5,
      "quoteCount": 0,
      "viewCount": "902",
      "bookmarkCount": 0,
      "createdAt": "Fri Sep 25 00:39:54 +0000 2026",
      "lang": "en",
      "isReply": false,
      "inReplyToId": null,
      "conversationId": "1900000000000000005",
      "displayTextRange": null,
      "entities": null,
      "quoted_tweet": null,
      "author": {
        "type": "user",
        "userName": "example_user12",
        "url": "https://x.com/example_user12",
        "id": "1000000000000000012",
        "name": "Example User 12",
        "isBlueVerified": true,
        "description": "Example bio.",
        "location": "",
        "followers": 192711,
        "following": 604,
        "statusesCount": null,
        "createdAt": "Mon Jan 15 18:50:00 +0000 2018",
        "profilePicture": "https://pbs.twimg.com/profile_images/example/avatar_normal.jpg",
        "coverPicture": null,
        "canDm": true,
        "pinnedTweetIds": [],
        "profile_bio": null
      }
    }
  ],
  "status": "success",
  "message": "",
  "has_next_page": true,
  "next_cursor": "DAAKCgABHTER46N__ncLAAIAAAGoRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUNVZE1GVWtnQmZCM2gwd1hRZzMyM0dESFRCTzgxaWJvSW9kTUR5cnE5cmhjUjB3Vm5paVd5RktIVEE0cEorV0VUTWRNRHNNQnBwQnd4MHdYWFlXbWdEREhURVF4SGdhQUFNZE1ENUdTVm9oM2gwd1ByRlcxa0FjSFRCRHZmbVd3UmtkTUxvaGRWc2hvUjB3UGdHVmxnRldIVERxQjdvYWdNQWRNRkhFemh2UjF4MHdrVktFRzBFTkhUQmt0N2tiUWI4ZE1Eb3lacGFoNWgwd1BtZmNXN0VuSFRBK2Q4dmJJVElkTUQrUmg1cmhqQjB3T1hXQzF3QkNIVERHREhSYVlIUWRNRTAyR0phZ1VoMHdVYWtDbWxEUUhUQkhXNlFiZ2F3ZE1MRURyMXJ4aGgwd1FXNmFtd0J2SFRFT3hER2FjWUVkTUpqRTlCb2h1QjB3YnF6Rm1nRlNIVEVFb1BiWEVWd2RNRUhQN2hzeE9SMHcyWFJrR2xFSkhURVFRM1ZiVUFrZE1MVi9pQnFBYWc9PQgAAwAAAAILAAQAAAAGQm90dG9tAAA"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}