Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks you through retrieving Quote Posts (Posts that quote another Post).
PrerequisitesBefore you begin, you’ll need:

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

Request Quote Posts

cURL
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"

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"
  }
}

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