---
title: "Retweets"
method: GET
path: "/v1/scrape/twitter/retweets"
tags: ["twitter"]
---

# Retweets

`GET /v1/scrape/twitter/retweets`

## Request

- Base URL: `https://api.sociavault.com`
- URL: `https://api.sociavault.com/v1/scrape/twitter/retweets`
- Auth: API key in header `X-API-Key`

Get users who retweeted a specific tweet. Results are paginated — use the cursor parameter to fetch additional pages. Returns up to 100 retweeters per request.

## Query parameters

- `pid` string, required
- `cursor` string

## Response `200`

Successful response

**Key Response Fields:**

**Pagination:**
- `data.cursor.bottom`: Pass as `cursor` query param to get the next page of retweeters
- `data.cursor.top`: Cursor for the previous page

**Timeline Structure:**
- `data.result.timeline.instructions[0].entries[]`: Array of retweeter entries (type `TimelineAddEntries`)

**Each Retweeter** (at `entries[].content.itemContent.user_results.result`):
- `.rest_id`: User's numeric ID
- `.is_blue_verified`: Whether user has a blue checkmark
- `.legacy.name`: Display name
- `.legacy.screen_name`: Handle (username without @)
- `.legacy.description`: Bio
- `.legacy.followers_count`: Follower count
- `.legacy.friends_count`: Following count
- `.legacy.statuses_count`: Total tweet count
- `.legacy.favourites_count`: Total likes given
- `.legacy.media_count`: Total media posts
- `.legacy.listed_count`: Number of lists the user is on
- `.legacy.created_at`: Account creation date
- `.legacy.location`: Location set by user
- `.legacy.profile_image_url_https`: Profile picture URL
- `.legacy.profile_banner_url`: Banner image URL
- `.legacy.protected`: Whether account is private
- `.legacy.verified`: Legacy verified status

## Other responses

- `400`: Bad Request - Invalid parameters or missing required fields
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient credits
- `500`: Internal Server Error

---

[API](https://skmtc.dev/sociavault/apis/sociavault-api.md) · [All operations](https://skmtc.dev/sociavault/apis/sociavault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociavault/apis/sociavault-api/revisions/0a430c97f53a?raw)