---
title: "Tweet Comments"
method: GET
path: "/v1/scrape/twitter/comments"
tags: ["twitter"]
---

# Tweet Comments

`GET /v1/scrape/twitter/comments`

## Request

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

Get comments (replies) on a specific tweet. Results are paginated. Use the cursor parameter to fetch additional pages.

## Query parameters

- `pid` string, required
- `rankingMode` 'Relevance' | 'Recency' | 'Likes'
- `cursor` string

## Response `200`

Successful response

**Key Response Fields:**

**Pagination:**
- `data.cursor.bottom`: Pass as `cursor` query param to get the next page of comments

**Comment List:**
- `data.result.instructions[0].entries[]`: Array of comment entries (type `TimelineAddEntries`)
- `data.result.instructions[1]`: `TimelineTerminateTimeline` — indicates end of available results

**Each Comment** (at `entries[].content.itemContent.tweet_results.result`):
- `.rest_id`: Comment tweet ID
- `.legacy.full_text`: Comment text
- `.legacy.created_at`: Timestamp when the comment was posted
- `.views.count`: View count (returned as string)
- `.legacy.favorite_count`: Likes
- `.legacy.retweet_count`: Retweets
- `.legacy.reply_count`: Replies
- `.legacy.quote_count`: Quote tweets
- `.legacy.bookmark_count`: Bookmarks
- `.legacy.lang`: Language code (e.g. `en`)
- `.legacy.conversation_id_str`: The original tweet ID this comment is replying to
- `.legacy.in_reply_to_status_id_str`: The tweet ID being directly replied to
- `.source`: App used to post
- `.note_tweet.note_tweet_results.result.text`: Full text for comments longer than 280 characters

**Comment Author** (at `entries[].content.itemContent.tweet_results.result.core.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.profile_image_url_https`: Profile picture URL

**Media** (at `entries[].content.itemContent.tweet_results.result.legacy.extended_entities.media[]`):
- `.type`: `photo`, `video`, or `animated_gif`
- `.media_url_https`: Image URL or video thumbnail
- `.video_info.variants[].url`: Video file URL

## 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 - Service configuration or processing 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)