# Users who retweeted a tweet

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

Accounts that retweeted a tweet.

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

## 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 users 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 turns X's ranking off. Any other value, or none, keeps it on. |

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 Retweeters query.

With `format=simple`: Collection of User objects: {data: [User], nextCursor, previousCursor, hasNextPage}.

## 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/retweets' \
  --header 'X-API-KEY: YOUR_API_KEY'
```

Python:

```python
from twittrapi import TwittrAPI

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

Node.js:

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

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

RapidAPI:

```bash
curl 'https://twitter-aio.p.rapidapi.com/tweet/20/retweets' \
  --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": {
    "retweeters_timeline": {
      "timeline": {
        "instructions": [
          {
            "entries": [
              {
                "content": {
                  "__typename": "TimelineTimelineItem",
                  "entryType": "TimelineTimelineItem",
                  "itemContent": {
                    "__typename": "TimelineUser",
                    "itemType": "TimelineUser",
                    "userDisplayType": "User",
                    "user_results": {
                      "result": {
                        "__typename": "User",
                        "affiliates_highlighted_label": {},
                        "has_graduated_access": true,
                        "id": "VXNlcjoxMDAwMDAwMDAwMDAwMDAwMDAx",
                        "is_blue_verified": false,
                        "legacy": {
                          "blocked_by": false,
                          "blocking": false,
                          "can_dm": true,
                          "can_media_tag": true,
                          "created_at": "Sat Dec 25 21:19:29 +0000 2021",
                          "default_profile": true,
                          "default_profile_image": false,
                          "description": "Example",
                          "entities": {
                            "description": {
                              "…": "…"
                            }
                          },
                          "fast_followers_count": 0,
                          "favourites_count": 6190,
                          "follow_request_sent": false,
                          "followed_by": false,
                          "followers_count": 415,
                          "following": false,
                          "friends_count": 470,
                          "has_custom_timelines": true,
                          "is_translator": false,
                          "listed_count": 0,
                          "location": "Example",
                          "media_count": 102,
                          "muting": false,
                          "name": "Example User 1",
                          "needs_phone_verification": false,
                          "normal_followers_count": 415,
                          "notifications": false,
                          "possibly_sensitive": false,
                          "profile_banner_url": "https://pbs.twimg.com/profile_banners/1000000000000000000/1700000000",
                          "profile_image_url_https": "https://pbs.twimg.com/profile_images/1000000000000000000/example_normal.jpg",
                          "profile_interstitial_type": "",
                          "protected": false,
                          "screen_name": "example_user_1",
                          "statuses_count": 1411,
                          "time_zone": "",
                          "translator_type": "none",
                          "url": "",
                          "utc_offset": 0,
                          "verified": false,
                          "want_retweets": false,
                          "withheld_description": "",
                          "withheld_scope": ""
                        },
                        "parody_commentary_fan_label": "None",
                        "profile_image_shape": "Circle",
                        "rest_id": "1000000000000000001",
                        "super_follow_eligible": false,
                        "super_followed_by": false,
                        "super_following": false,
                        "tipjar_settings": {}
                      }
                    }
                  }
                },
                "entryId": "user-1000000000000000001",
                "sortIndex": "1878501968610066432"
              },
              "… 3 more"
            ],
            "type": "TimelineAddEntries"
          }
        ],
        "responseObjects": {}
      }
… (3 more lines)
```

Simple (`format=simple`):

```json
{
  "data": [
    {
      "id": "1000000000000000001",
      "username": "example_user_1",
      "name": "Example User 1",
      "description": "Example",
      "location": "Example",
      "url": null,
      "createdAt": "2021-12-25T21:19:29Z",
      "avatarUrl": "https://pbs.twimg.com/profile_images/1000000000000000000/example.jpg",
      "bannerUrl": "https://pbs.twimg.com/profile_banners/1000000000000000000/1700000000",
      "verified": false,
      "verifiedType": null,
      "protected": false,
      "counts": {
        "followers": 415,
        "following": 470,
        "tweets": 1411,
        "likes": 6190,
        "media": 102,
        "listed": 0
      },
      "pinnedTweetIds": [],
      "isAutomated": false
    },
    "… 1 more"
  ],
  "nextCursor": "HBaAgIC+kLf1iDQAAA==",
  "previousCursor": "HCaAgIDOzuXjkTQAAA==",
  "hasNextPage": true
}
```