X (Twitter) API Guide

How to Schedule Quote Tweets on X via API

Schedule quote tweets on X (Twitter) using the PostFast API. Add your commentary to existing tweets programmatically.

Last updated: January 2025
Automate your X engagement strategyGet API Key

Quote tweets allow you to share someone else's tweet with your own commentary, creating engagement opportunities and adding context. Using the PostFast API, you can schedule quote tweets by providing the xQuoteTweetUrl parameter.

Quote tweets are powerful for thought leadership (adding insights to industry news), engagement (participating in conversations), curation (sharing valuable content with your audience), and commentary (providing context or alternative perspectives).

When scheduling a quote tweet, you provide both your commentary in the content field and the URL of the tweet you want to quote in the xQuoteTweetUrl control.

API Parameters

ParameterTypeDescription
xQuoteTweetUrlstringURL of tweet to quote with commentary. Supports content and media attachments. Accepted formats: x.com, twitter.com, mobile.twitter.com

Code Example

const response = await fetch('https://api.postfa.st/social-posts', {
  method: 'POST',
  headers: {
    'pf-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
        "posts": [
            {
                "content": "This is exactly why we built PostFast. Scheduling shouldn't be complicated.\n\nOur API makes this dead simple 👇",
                "mediaItems": [],
                "scheduledAt": "2025-01-31T15:00:00.000Z",
                "socialMediaId": "dd3l5166-n0hj-19l2-i594-223433227009"
            }
        ],
        "controls": {
            "xQuoteTweetUrl": "https://x.com/elonmusk/status/1234567890123456789"
        }
    })
});

const data = await response.json();

Did You Know?

Character Limit
280 characters
Your commentary is limited to 280 characters, same as regular tweets
URL Formats
x.com, twitter.com
Accepts x.com, twitter.com, and mobile.twitter.com URLs
Media Support
Images allowed
You can add your own images alongside your quote tweet commentary
Original Tweet
Must be public
You can only quote public tweets. Protected tweets cannot be quoted.

Tips

Add genuine value with your commentary - don't just say "This!" or "So true!"

Quote tweets work great for industry news curation with your expert take

You can add images to your quote tweet for extra visual impact

Time your quote tweets when the original conversation is active for maximum engagement

Schedule quote tweets, retweets, and original content via API

7-day free trial
Try PostFast Free

Common Pitfalls

Invalid tweet URL

The tweet URL must be valid and the tweet must be public. Private or deleted tweets cannot be quoted and will cause an error.

Using both quote and retweet

You cannot use xQuoteTweetUrl and xRetweetUrl together. Choose one - quote tweet (with commentary) or retweet (without commentary).

Empty commentary

While technically possible, quote tweets without commentary provide little value. Add your perspective to make it worthwhile.

Frequently Asked Questions

What's the difference between quote tweets and retweets?

Quote tweets let you add your own commentary and appear as a new tweet on your timeline. Retweets share the original without changes. Use xQuoteTweetUrl for quotes, xRetweetUrl for retweets.

Can I quote a tweet with media attached?

Yes! The quoted tweet displays with its original media, and you can also add your own images to your commentary. Your images appear above the quoted tweet.

What URL formats are accepted?

PostFast accepts x.com, twitter.com, and mobile.twitter.com URLs. Example: https://x.com/username/status/1234567890 or https://twitter.com/username/status/1234567890

Build your X presence with programmatic posting

Start Free Trial
7-day free trialCancel anytime