Quickstart

This guide walks you through retrieving Quote Posts (Posts that quote another Post). Before you begin, you’ll need: - A developer. Enterprise X API v2 tier.

This guide walks you through retrieving Quote Posts (Posts that quote another Post).

Prerequisites

Before you begin, you’ll need:

• A developer account with an approved App
• Your App’s Bearer Token

---

1. Find the Post ID

   Get the ID of the Post you want to find quotes for. You can find it in the Post’s URL:

   https://x.com/XDevelopers/status/1409931481552543749
                                   └── This is the Post ID
   
2. Request Quote Posts

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/1409931481552543749/quote_tweets?\
   tweet.fields=created_at,public_metrics,author_id&\
   expansions=author_id&\
   user.fields=username,verified&\
   max_results=10" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Review the response

   {
     "data": [
       {
         "id": "1495979553889697792",
         "text": "Great thread on the new API features! https://t.co/...",
         "author_id": "29757971",
         "created_at": "2022-02-22T04:31:34.000Z",
         "public_metrics": {
           "retweet_count": 5,
           "reply_count": 2,
           "like_count": 42,
           "quote_count": 1
         },
         "edit_history_tweet_ids": ["1495979553889697792"]
       }
     ],
     "includes": {
       "users": [
         {
           "id": "29757971",
           "username": "developer",
           "verified": false
         }
       ]
     },
     "meta": {
       "result_count": 1,
       "next_token": "avdjwk0udyx6"
     }
   }
   
4. Paginate through results

   The SDKs handle pagination automatically. For cURL, use the next_token to get more Quote Posts:

   curl "https://api.x.com/2/tweets/1409931481552543749/quote_tweets?\
   max_results=10&\
   pagination_token=avdjwk0udyx6" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

---

Next steps

Retweets

Look up Retweets

Post lookup

Look up Posts by ID

API Reference

Full endpoint documentation