TwitterAPIs Docs
API ReferenceTweet Details

Twitter Retweeters API | Who Retweeted a Tweet

Fetch the users who retweeted a given tweet, cursor-paginated. Useful for amplification analysis and identifying the accounts that spread a post. Cost: $0.0008 per call.

Tweet Retweeters lists the accounts that retweeted a given tweet, cursor-paginated as full user objects. Use it for amplification analysis and to identify the specific accounts that spread a post. Pass a tweet ID or URL; each page is one $0.0008 read at the standard rate.

GET
/tweet/retweeters

Authorization

bearerAuth
AuthorizationBearer <token>

Pass your API key as a bearer token on every request: Authorization: Bearer <API_KEY>.

In: header

Query Parameters

id?string

Numeric ID of the tweet. Provide either id or url.

url?string

Full status URL of the tweet. Provide either id or url.

cursor?string

Pagination cursor from a previous response.

count?integer

Max items to return for this page. Default 20; clamped to 1-100.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tweet/retweeters?id=1759123456789012345&url=https%3A%2F%2Fx.com%2Fnaval%2Fstatus%2F1759123456789012345&count=20"
{  "users": [    {      "id": "9921",      "username": "devjane",      "name": "Jane",      "followers_count": 4200,      "verified": false    }  ],  "next_cursor": "DAABCgABF..."}
{  "error": "bad_request",  "message": "Missing or malformed parameter. Fix the request before retrying."}
{  "error": "unauthorized",  "message": "The API key is missing, malformed, or revoked. Check the Authorization header."}
{  "error": "insufficient_credits",  "message": "Your balance is exhausted. Top up your credits to continue."}
{  "error": "not_found",  "message": "The resource does not exist, for example a deleted tweet or a private account."}
{  "error": "rate_limited",  "message": "Too many requests. Back off and retry with exponential backoff."}
{  "error": "server_error",  "message": "Something failed on our side. Retry with backoff; if it persists, contact support."}

Pricing

UnitPrice
Per call$0.0008
Per 1,000 calls$0.80
Per 1,000 records (~20 per call)~$0.04

Each page of retweeters is one $0.0008 read, so a widely-shared tweet costs one call per page. Cap paging to the reach sample you need.

When to use

Use it for amplification analysis, for example identifying which high-follower accounts retweeted your announcement.

Pagination

This endpoint is cursor-paginated and returns roughly 20 records per call. Pass the next_cursor from each response back as the cursor parameter to read the next page. Stop when the records array comes back empty: follower-graph endpoints return a non-null cursor even on the final page, so the empty array is the only reliable stop signal. See Pagination for the full loop.

FAQ

Does Tweet Retweeters include quote tweets?

It returns accounts that retweeted the post directly. To find quote tweets, search the tweet URL with Advanced Tweet Search instead.

What does each retweeter row contain?

Each row is a full user object with id, username, name, follower count, and verification, so you can rank reach without a second call.

How do I read every retweeter?

Page with next_cursor until the users array comes back empty, which is the universal stop signal.