Manage Retweets

This guide walks you through Retweeting and undoing Retweets using the X API. Reference for the X API v2 standard tier covering quickstart.

This guide walks you through Retweeting and undoing Retweets using the X API.

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• User Access Token (OAuth 1.0a or OAuth 2.0 PKCE)

---

Retweet a Post

1. Get your user ID

   You need your authenticated user’s ID. You can find it using the user lookup endpoint or from your Access Token (the numeric part is your user ID).

2. Get the Post ID

   Find the Post ID in the URL when viewing a Post:

   https://x.com/XDevelopers/status/1228393702244134912
                                   └── This is the Post ID
   
3. Send the Retweet request

   cURL

   shellscript

   curl -X POST "https://api.x.com/2/users/123456789/retweets" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"tweet_id": "1228393702244134912"}'
   

   from xdk import Client
   from xdk.oauth1_auth import OAuth1
   
   oauth1 = OAuth1(
       api_key="YOUR_API_KEY",
       api_secret="YOUR_API_SECRET",
       access_token="YOUR_ACCESS_TOKEN",
       access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
   )
   
   client = Client(auth=oauth1)
   
   # Retweet a Post
   response = client.posts.retweet(
       user_id="123456789",
       tweet_id="1228393702244134912"
   )
   
   print(f"Retweeted: {response.data.retweeted}")
   

   import { Client, OAuth1 } from "@xdevplatform/xdk";
   
   const oauth1 = new OAuth1({
     apiKey: "YOUR_API_KEY",
     apiSecret: "YOUR_API_SECRET",
     accessToken: "YOUR_ACCESS_TOKEN",
     accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
   });
   
   const client = new Client({ oauth1 });
   
   // Retweet a Post
   const response = await client.posts.retweet("123456789", {
     tweetId: "1228393702244134912",
   });
   
   console.log(`Retweeted: ${response.data?.retweeted}`);
   
4. Review the response

   {
     "data": {
       "retweeted": true
     }
   }
   

---

Undo a Retweet

Remove a Retweet:

cURL

shellscript

curl -X DELETE "https://api.x.com/2/users/123456789/retweets/1228393702244134912" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Undo a Retweet
response = client.posts.unretweet(
    user_id="123456789",
    tweet_id="1228393702244134912"
)

print(f"Retweeted: {response.data.retweeted}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Undo a Retweet
const response = await client.posts.unretweet("123456789", "1228393702244134912");

console.log(`Retweeted: ${response.data?.retweeted}`);

Response:

{
  "data": {
    "retweeted": false
  }
}

---

Next steps

Retweets lookup

Get users who Retweeted a Post

Quote Posts

Get Quote Posts

API Reference

Full endpoint documentation