twitter

Tweet Comments

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

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

Query parameters

pidstring required
Example:1234567890123456789

The tweet ID to get comments for

rankingMode'Relevance' | 'Recency' | 'Likes'
Example:Relevance

Sort comments by ranking criterion: Relevance (default), Recency (most recent), or Likes (highest likes)

cursorstring

Pagination cursor from a previous response to get the next page of results

Response

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

Changes

No recorded changes to this operation across all 1 revision of this API.