---
title: "Quotes"
method: GET
path: "/v1/scrape/twitter/quotes"
tags: ["twitter"]
---

# Quotes

`GET /v1/scrape/twitter/quotes`

## Request

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

Get tweets that quote a specific tweet. Results are paginated — use the cursor parameter to fetch additional pages. Returns up to 20 quote tweets 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 quotes
- `data.cursor.top`: Cursor for the previous page

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

**Each Quote Tweet** (at `entries[].content.itemContent.tweet_results.result`):
- `.rest_id`: Tweet ID
- `.legacy.full_text`: Tweet text
- `.legacy.created_at`: When the quote tweet was posted
- `.legacy.favorite_count`: Like count
- `.legacy.retweet_count`: Retweet count
- `.legacy.reply_count`: Reply count
- `.legacy.quote_count`: Quote count
- `.legacy.bookmark_count`: Bookmark count
- `.legacy.lang`: Language code
- `.legacy.is_quote_status`: Always `true` for quote tweets
- `.legacy.quoted_status_id_str`: ID of the original quoted tweet
- `.views.count`: View count
- `.note_tweet.note_tweet_results.result.text`: Full expanded text (for long tweets)

**Quote Tweet Author** (at `.core.user_results.result`):
- `.rest_id`: Author's numeric ID
- `.is_blue_verified`: Whether author has a blue checkmark
- `.legacy.name`: Display name
- `.legacy.screen_name`: Handle (username without @)
- `.legacy.description`: Bio
- `.legacy.followers_count`: Follower count
- `.legacy.profile_image_url_https`: Profile picture URL
- `.professional.professional_type`: `Creator` or `Business` (if applicable)

**Quoted Original Tweet** (at `.quoted_status_result.result`):
- Same structure as above — includes the original tweet's text, stats, author, and media

**Feedback Actions:**
- `data.result.timeline.responseObjects.feedbackActions[]`: User feedback options (not helpful, not relevant, not credible)

## 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)