# Quote tweets

`GET https://api.twittrapi.com/tweet/{tweetId}/quotes`

Tweets that quote a tweet.

HTML page: https://www.twittrapi.com/docs/reference/tweet-tweetid-quotes

## Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `tweetId` | path | string | yes |  | Numeric tweet ID (digits only, up to 30), the number at the end of the tweet URL. |
| `count` | query | integer | no | 20 | Number of tweets to ask X for. Sent to X as is; X treats it as a hint and decides how many it returns (follower and following pages often hold 50 to 70 users for count=20). A value that is not a number falls back to 20. |
| `cursor` | query | string | no |  | Bottom cursor from the previous page. Leave it out for the first page. See Pagination. |
| `rankingMode` | query | string | no |  | Recency returns the newest quotes first (Latest tab). Anything else uses the Top tab. |

Every read endpoint also accepts `format=simple` (or the header `X-Response-Format: simple`) for compact, flat JSON with a fixed schema. Same price.

Paginated: pass the bottom cursor of one page as `cursor` to get the next. Each page is one billed call.

## Response

Raw JSON of X's SearchTimeline for quoted_tweet_id:<tweetId>. Unlike /search, it is not wrapped in {category, entries}.

With `format=simple`: Collection of Tweet objects: {data: [Tweet], nextCursor, previousCursor, hasNextPage}. Each item quotes the tweet (quoted).

## Errors

| Status | When |
| --- | --- |
| 422 | tweetId is not numeric. |

Shared errors (401 missing key, 402 no balance, 429 rate limit, 5xx) are listed on https://www.twittrapi.com/docs/helpful-infos/error-handling. Calls that fail with 400, 408, 409 or a 5xx error are refunded.

## Example request

curl:

```bash
curl 'https://api.twittrapi.com/tweet/20/quotes' \
  --header 'X-API-KEY: YOUR_API_KEY'
```

Python:

```python
from twittrapi import TwittrAPI

client = TwittrAPI(api_key="YOUR_API_KEY")
data = client.tweets.quotes("20")
```

Node.js:

```js
import { TwittrAPI } from "twittrapi";

const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
const data = await client.tweets.quotes({ tweetId: "20" });
```

RapidAPI:

```bash
curl 'https://twitter-aio.p.rapidapi.com/tweet/20/quotes' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
  --header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'
```

## Example response

Shortened: arrays keep their first items and long strings are cut.

Raw (default):

```json
{
  "data": {
    "search_by_raw_query": {
      "search_timeline": {
        "timeline": {
          "instructions": [
            {
              "entries": [
                {
                  "content": {
                    "__typename": "TimelineTimelineItem",
                    "clientEventInfo": {
                      "component": "result",
                      "details": {
                        "timelinesDetails": {
                          "controllerData": "DAACDAAFDAABDAABDAABCgABAAAAAAACAAAKAARrZsZzAPh0SQAADAACCgABAAAAAAAAAAAKAAJqHGK7stjygwoABQaJTTBeTByxCAAGAAAAAAoAB0ufWcra…"
                        }
                      },
                      "element": "tweet"
                    },
                    "entryType": "TimelineTimelineItem",
                    "feedbackInfo": {
                      "feedbackKeys": [
                        "1060665035"
                      ]
                    },
                    "itemContent": {
                      "__typename": "TimelineTweet",
                      "itemType": "TimelineTweet",
                      "tweetDisplayType": "Tweet",
                      "tweet_results": {
                        "result": {
                          "__typename": "Tweet",
                          "cashtag_attachments": [],
                          "core": {
                            "user_results": {
                              "…": "…"
                            }
                          },
                          "edit_control": {
                            "edit_tweet_ids": [
                              "…"
                            ],
                            "editable_until_msecs": "1770472555000",
                            "edits_remaining": "5",
                            "is_edit_eligible": true
                          },
                          "grok_analysis_button": true,
                          "grok_annotations": {
                            "is_image_editable_by_grok": false
                          },
                          "grok_translated_post_with_availability": {
                            "is_available": false
                          },
                          "is_translatable": false,
                          "legacy": {
                            "bookmark_count": 3,
                            "bookmarked": false,
                            "conversation_id_str": "2000000000000000001",
                            "created_at": "Sat Feb 07 12:55:55 +0000 2026",
                            "display_text_range": [
                              "…"
                            ],
                            "entities": {
                              "…": "…"
                            },
                            "favorite_count": 13,
                            "favorited": false,
                            "full_text": "Example text.",
                            "id_str": "2000000000000000001",
                            "is_quote_status": true,
                            "lang": "en",
                            "quote_count": 0,
                            "quoted_status_id_str": "2019881223666233717",
                            "quoted_status_permalink": {
                              "…": "…"
                            },
                            "reply_count": 4,
                            "retweet_count": 0,
                            "retweeted": false,
                            "user_id_str": "1000000000000000001"
                          },
                          "quoted_status_result": {
                            "result": {
                              "…": "…"
                            }
                          },
                          "rest_id": "2000000000000000001",
                          "unmention_data": {},
                          "views": {
… (45 more lines)
```

Simple (`format=simple`):

```json
{
  "data": [
    {
      "id": "2000000000000000001",
      "url": "https://x.com/example_user_1/status/2000000000000000001",
      "text": "Example text.",
      "createdAt": "2026-02-07T12:55:55Z",
      "lang": "en",
      "author": {
        "id": "1000000000000000001",
        "username": "example_user_1",
        "name": "Example User 1",
        "description": "Example",
        "location": "Example",
        "url": "https://example.com",
        "createdAt": "2013-02-06T11:52:24Z",
        "avatarUrl": "https://pbs.twimg.com/profile_images/1000000000000000000/example.jpg",
        "bannerUrl": "https://pbs.twimg.com/profile_banners/1000000000000000000/1700000000",
        "verified": true,
        "verifiedType": null,
        "protected": false,
        "counts": {
          "followers": 16404,
          "following": 1172,
          "tweets": 24710,
          "likes": 26263,
          "media": 2185,
          "listed": 0
        },
        "pinnedTweetIds": [],
        "isAutomated": false
      },
      "counts": {
        "likes": 13,
        "retweets": 0,
        "replies": 4,
        "quotes": 0,
        "bookmarks": 3,
        "views": 3160
      },
      "media": [],
      "urls": [],
      "hashtags": [],
      "mentions": [],
      "replyTo": null,
      "quoted": {
        "id": "2019881223666233717",
        "url": "https://x.com/XDevelopers/status/2019881223666233717",
        "text": "Officially launching X API Pay-Per-Use\n\nThe core of X developers are indie builders, early stage products, startups, and hobbyists\n\nIt’s time to open up our X API ecosystem and instill a new wave of n…",
        "createdAt": "2026-02-06T21:09:45Z",
        "lang": "en",
        "author": {
          "id": "2244994945",
          "username": "XDevelopers",
          "name": "Developers",
          "description": "The voice of the X Dev team and your official source for updates, news, and events, related to the X API.",
          "location": "127.0.0.1",
          "url": "https://docs.x.com/",
          "createdAt": "2013-12-14T04:35:55Z",
          "avatarUrl": "https://pbs.twimg.com/profile_images/1683501992314798080/xl1POYLw.jpg",
          "bannerUrl": "https://pbs.twimg.com/profile_banners/2244994945/1690213128",
          "verified": true,
          "verifiedType": "Business",
          "protected": false,
          "counts": {
            "followers": 698074,
            "following": 770,
            "tweets": 4376,
            "likes": 2758,
            "media": 832,
            "listed": 0
          },
          "pinnedTweetIds": [
            "2019881223666233717"
          ],
          "isAutomated": false
        },
        "counts": {
          "likes": 5599,
          "retweets": 896,
          "replies": 791,
          "quotes": 596,
          "bookmarks": 2803,
          "views": 2552260
        },
        "media": [],
        "urls": [
          "http://developer.x.com"
        ],
        "hashtags": [],
… (20 more lines)
```
