> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tweet Comments
> Get comments (replies) on a specific tweet. Results are paginated. Use the cursor parameter to fetch additional pages.
đź’ł **1 credit** per request
## OpenAPI
````yaml GET /v1/scrape/twitter/comments
openapi: 3.1.0
info:
title: SociaVault API
version: 1.0.0
description: >-
# SociaVault API Documentation
The SociaVault API provides comprehensive access to social media data
extraction across multiple platforms.
## Features
- **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter,
Reddit, Threads, and more
- **Credit-Based System**: Pay-as-you-go pricing with transparent credit
costs
- **High Performance**: Fast, reliable data extraction
- **Comprehensive Data**: Detailed user profiles, videos, posts, comments,
and analytics
## Authentication
All API requests require authentication using an API key in the `X-API-Key`
header:
```bash
X-API-Key: sk_live_your_api_key_here
```
Get your API key from the [SociaVault
Dashboard](https://sociavault.com/dashboard).
## Credits
Each endpoint consumes credits based on data complexity:
- Simple requests (profiles): 1 credit
- Complex requests (demographics): 20+ credits
- Paginated requests: Credits per page
Check your credit balance in the dashboard or via the API.
## Support
- **Documentation**: https://docs.sociavault.com
- **Email**: support@sociavault.com
- **Discord**: https://discord.gg/sociavault
contact:
name: SociaVault Support
email: support@sociavault.com
url: https://sociavault.com/support
license:
name: Commercial
url: https://sociavault.com/terms
servers:
- url: https://api.sociavault.com
description: Production API
security:
- ApiKeyAuth: []
tags:
- name: account
description: Account management and credit balance
externalDocs:
description: Learn more
url: https://docs.sociavault.com/account
- name: tiktok
description: Scrape TikTok profiles, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok
- name: tiktok-shop
description: Everything about TikTok Shop
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/tiktok-shop
- name: instagram
description: Gets Instagram profiles, posts, and reels
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/instagram
- name: youtube
description: Scrape YouTube channels, videos, and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/youtube
- name: linkedin
description: Scrape LinkedIn
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedin
- name: facebook
description: Get public Facebook profiles and posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebook
- name: facebookAdLibrary
description: Scrapes the Facebook (Meta) Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookAdLibrary
- name: facebookMarketplace
description: Search Facebook Marketplace and pull full listing details
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/facebookMarketplace
- name: googleAdLibrary
description: >-
Scrape the Google Ad Transparency Library. *This only gets the public ads.
Some ads you need to log in for and sadly we can't get those. Also, since
there are so many variations, the return types might not all be 100% the
same.
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/googleAdLibrary
- name: linkedinAdLibrary
description: Search the LinkedIn Ad Library
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/linkedinAdLibrary
- name: twitter
description: Get Twitter profiles, tweets, followers and more
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/twitter
- name: reddit
description: Scrape Reddit posts and comments
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/reddit
- name: threads
description: Get Threads posts
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/threads
- name: google
description: Scrape Google search results
externalDocs:
description: Learn more
url: https://docs.sociavault.com/platforms/google
paths:
/v1/scrape/twitter/comments:
get:
tags:
- twitter
summary: Tweet Comments
description: >-
Get comments (replies) on a specific tweet. Results are paginated. Use
the cursor parameter to fetch additional pages.
operationId: twitter_Tweet_Comments
parameters:
- name: pid
in: query
description: The tweet ID to get comments for
required: true
schema:
type: string
example: '1234567890123456789'
- name: rankingMode
in: query
description: >-
Sort comments by ranking criterion: Relevance (default), Recency
(most recent), or Likes (highest likes)
required: false
schema:
type: string
enum:
- Relevance
- Recency
- Likes
example: Relevance
- name: cursor
in: query
description: >-
Pagination cursor from a previous response to get the next page of
results
required: false
schema:
type: string
responses:
'200':
description: >-
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
content:
application/json:
example:
success: true
data:
error: false
cursor:
bottom: >-
bQAAAPBeHBm2kMHa9dzmvZw4tMO9jbOev5w40ITd_f6Ovpw47oOxiav515w4-sG50Z6No5447MK8-dbqm_s31MDX3Zn315w4rIfUrdHa5Jw4zMXb-evp-pw48IPXoZzzxJw4iIG7sbLW15w4JQISFQQAAA
result:
instructions:
- entries:
- content:
__typename: TimelineTimelineItem
clientEventInfo:
component: tweet
element: tweet
entryType: TimelineTimelineItem
itemContent:
__typename: TimelineTweet
hasModeratedReplies: true
itemType: TimelineTweet
tweetDisplayType: SelfThread
tweet_results:
result:
__typename: Tweet
core:
user_results:
result:
__typename: User
affiliates_highlighted_label: {}
has_graduated_access: true
id: VXNlcjoxMDk2NDM2NDUyNTc2MDQ3MTA0
is_blue_verified: true
legacy:
blocked_by: false
blocking: false
can_dm: false
can_media_tag: true
created_at: Fri Feb 15 15:49:55 +0000 2019
default_profile: true
default_profile_image: false
description: >-
Chief Market Strategist @FuturumEquities
| Contributor @Reuters @Bloomberg
@MarketWatch @Forbes | Not investment
advice
entities:
description:
urls: []
url:
urls:
- display_url: savvytrader.com/StockSavvyShay…
expanded_url: >-
https://savvytrader.com/StockSavvyShay/shays-growth-portfolio?s=MTY5OTM6MzgxOA==
indices:
- 0
- 23
url: https://t.co/K2h2dfkZci
fast_followers_count: 0
favourites_count: 33560
follow_request_sent: false
followed_by: false
followers_count: 356838
following: false
friends_count: 287
has_custom_timelines: true
is_translator: false
listed_count: 4656
location: Portfolio Access →
media_count: 12803
muting: false
name: Shay Boloor
normal_followers_count: 356838
notifications: false
pinned_tweet_ids_str:
- '2025628639304589361'
possibly_sensitive: false
profile_banner_url: >-
https://pbs.twimg.com/profile_banners/1096436452576047104/1749157739
profile_image_url_https: >-
https://pbs.twimg.com/profile_images/1878129937737187328/DnEflT4L_normal.jpg
profile_interstitial_type: ''
protected: false
screen_name: StockSavvyShay
statuses_count: 31266
translator_type: none
url: https://t.co/K2h2dfkZci
verified: false
want_retweets: false
withheld_in_countries: []
professional:
category: []
professional_type: Creator
rest_id: '1637943661999820800'
profile_image_shape: Circle
rest_id: '1096436452576047104'
super_follow_eligible: true
super_followed_by: false
super_following: false
tipjar_settings:
is_enabled: true
edit_control:
edit_tweet_ids:
- '2025628639304589361'
editable_until_msecs: '1771786076000'
edits_remaining: '5'
is_edit_eligible: false
is_translatable: false
legacy:
bookmark_count: 231
bookmarked: false
conversation_id_str: '2025628639304589361'
created_at: Sun Feb 22 17:47:56 +0000 2026
display_text_range:
- 0
- 278
entities:
hashtags: []
media:
- allow_download_status:
allow_download: true
display_url: pic.x.com/S5jAqT8cQH
expanded_url: >-
https://x.com/StockSavvyShay/status/2025628639304589361/photo/1
ext_media_availability:
status: Available
features:
large:
faces: []
medium:
faces: []
orig:
faces: []
small:
faces: []
id_str: '2025618565483929600'
indices:
- 279
- 302
media_key: 3_2025618565483929600
media_results:
result:
media_key: 3_2025618565483929600
media_url_https: >-
https://pbs.twimg.com/media/HBxxWmYbIAAA_4p.png
original_info:
focus_rects:
- h: 360
w: 642
x: 0
'y': 407
- h: 642
w: 642
x: 0
'y': 230
- h: 732
w: 642
x: 0
'y': 140
- h: 872
w: 436
x: 0
'y': 0
- h: 872
w: 642
x: 0
'y': 0
height: 872
width: 642
sizes:
large:
h: 872
resize: fit
w: 642
medium:
h: 872
resize: fit
w: 642
small:
h: 680
resize: fit
w: 501
thumb:
h: 150
resize: crop
w: 150
type: photo
url: https://t.co/S5jAqT8cQH
symbols: []
timestamps: []
urls: []
user_mentions: []
extended_entities:
media:
- allow_download_status:
allow_download: true
display_url: pic.x.com/S5jAqT8cQH
expanded_url: >-
https://x.com/StockSavvyShay/status/2025628639304589361/photo/1
ext_media_availability:
status: Available
features:
large:
faces: []
medium:
faces: []
orig:
faces: []
small:
faces: []
id_str: '2025618565483929600'
indices:
- 279
- 302
media_key: 3_2025618565483929600
media_results:
result:
media_key: 3_2025618565483929600
media_url_https: >-
https://pbs.twimg.com/media/HBxxWmYbIAAA_4p.png
original_info:
focus_rects:
- h: 360
w: 642
x: 0
'y': 407
- h: 642
w: 642
x: 0
'y': 230
- h: 732
w: 642
x: 0
'y': 140
- h: 872
w: 436
x: 0
'y': 0
- h: 872
w: 642
x: 0
'y': 0
height: 872
width: 642
sizes:
large:
h: 872
resize: fit
w: 642
medium:
h: 872
resize: fit
w: 642
small:
h: 680
resize: fit
w: 501
thumb:
h: 150
resize: crop
w: 150
type: photo
url: https://t.co/S5jAqT8cQH
favorite_count: 1497
favorited: false
full_text: >-
THE $500K LAWSUIT I NEVER SHOULD HAVE
FACED
Last summer I was served with a lawsuit
claiming I had defrauded someone out of
nearly $500,000 by convincing her to
“invest” based on insider political
contacts and penny stock tips. If you’ve
followed me at all, you know how absurd
https://t.co/S5jAqT8cQH
id_str: '2025628639304589361'
is_quote_status: false
lang: en
possibly_sensitive: false
possibly_sensitive_editable: true
quote_count: 28
reply_count: 319
retweet_count: 82
retweeted: false
user_id_str: '1096436452576047104'
note_tweet:
is_expandable: true
note_tweet_results:
result:
entity_set:
hashtags: []
symbols: []
urls: []
user_mentions: []
id: Tm90ZVR3ZWV0OjIwMjU2Mjg2Mzg2NTQ0Mzk0MjQ=
media:
inline_media: []
richtext:
richtext_tags: []
text: >-
THE $500K LAWSUIT I NEVER SHOULD HAVE
FACED
Last summer I was served with a lawsuit
claiming I had defrauded someone out of
nearly $500,000 by convincing her to
“invest” based on insider political
contacts and penny stock tips. If you’ve
followed me at all, you know how absurd
that is. I don’t solicit money or run
private WhatsApp groups and I don’t
engage in insider trading.
It quickly became clear this was an
impersonation scam. Someone had used my
name and face to gain trust, moved the
conversation to an encrypted app like
WhatsApp or Telegram and pressured this
person into sending money. It’s the same
scam playbook retail investors are
warned about all the time but this time
my identity was the costume.
I initially thought the truth would end
it quickly since I had never spoken to
this person, never used the number
involved and never received a dollar. I
assumed basic investigation would make
that obvious but what happened next was
worse. Instead of treating this as a
clear case of mistaken identity and
using proper due diligence, opposing
counsel pushed forward anyway and
treated the lawsuit as leverage.
I provided evidence that the number
involved was not mine, that it was out
of state, that there was no link to my
devices, my accounts or my life. To top
it off, when the number they were in
communication with was called, someone
named Kevin selling Walmart gift cards
answered. The opposing council's
response was essentially “we will
proceed and see what we can find.” That
is not how justice is supposed to work
because lawsuits are not supposed to be
fishing expeditions where you smear
someone publicly first and decide later
if facts exist.
And then came the part that still
stings.
I was on my honeymoon when some fintwit
trolls started circulating the lawsuit
online, spinning it as “Shay is being
sued for stealing money” and calling me
a fraud. If you’ve ever been on the
receiving end of a viral accusation then
you know how powerless that feels. You
can’t responsibly litigate an active
case on social media and the louder the
lie gets, the more silence starts to
feel like guilt since it hijacked what
should have been one of the happiest
moments of my life. My wife and I were
trying to celebrate a once-in-a-lifetime
milestone while I watched my reputation
get dragged in real time.
I ultimately brought in serious
representation because I was seeing how
little truth actually mattered and was
fortunate to be connected with Patrick
and Jerry from Hawxhurst LLP. They
immediately recognized the absurdity of
the situation and they were able to shut
this down and have the case dismissed in
my favor within weeks.
However, the “win” doesn’t erase what it
cost. It cost more than my wedding and
honeymoon combined. It put strain on the
beginning of my marriage. It forced me
to manage a crisis I didn’t create and
it showed me how easily a public
narrative can be weaponized when someone
thinks they can pressure you into paying
just to make noise go away.
We like to think we live in a justice
system but much of what people
experience is a legal system and those
are not the same thing. The truth in my
case was never complicated. There was no
evidence I did what I was accused of and
there were obvious signs this was
impersonation but once the machine is
moving, truth alone doesn’t stop it
since pain and reputational damage
become the weapon.
I truly feel so bad for my wife because
she was the ultimate victim in this
since this all bled into our wedding and
our honeymoon where this period was
supposed to be about us, about
celebrating something rare and
meaningful and instead there were days
where my attention, my energy and my
emotional bandwidth were pulled into
stress, fear and damage control. Your
wedding is supposed to be sacred and
your honeymoon is supposed to be the
exhale after years of building and
pushing and sacrificing. I feel deep
guilt about that because my wife did not
sign up for this and she carried some of
this weight with me simply because she
loves me. That is the part that stays
with you because you cannot rewind it
and do it over. That loss is permanent
and no court order can give that back to
me.
So even though the case is resolved and
the truth is on the record, it does not
sit right with me that the people who
caused this get to walk away while I
carry the cost in time, money, stress,
and moments I will never get back. Being
forced to spend your wedding and
honeymoon dealing with a situation you
did not create is not something you
simply “move on” from. There is no real
remedy for that kind of loss and that is
the part that makes this feel so deeply
unjust.
I am looking seriously at all of my
options right now (not out of revenge)
but out of principle since the idea that
someone can misuse the legal system,
ignore basic facts, damage a person’s
reputation and impose real
emotional/financial harm with so little
accountability does not sit right with
me.
I am still processing what this took
from me and I am still figuring out what
the right next step is but I know this
much that being silent about it and
simply absorbing the damage is not
something I am comfortable with. I did
nothing wrong and I do not believe that
being the victim of something like this
should come with the expectation that
you quietly carry the cost while others
walk away untouched.
rest_id: '2025628639304589361'
source: >-
Twitter Web App
unmention_data: {}
views:
count: '503355'
state: EnabledWithCount
entryId: tweet-2025628639304589361
sortIndex: '7197743397550186446'
type: TimelineAddEntries
- direction: Top
type: TimelineTerminateTimeline
metadata:
reader_mode_config:
is_reader_mode_available: true
credits_used: 1
endpoint: twitter/comments
'400':
description: Bad Request - Invalid parameters or missing required fields
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: pid (tweet ID) is required
endpoint:
type: string
credits_required:
type: integer
required:
- error
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid API key
docs:
type: string
example: https://docs.sociavault.com/authentication
required:
- error
'402':
description: Payment Required - Insufficient credits
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Insufficient credits
required:
type: integer
example: 1
description: Credits required for this request
available:
type: integer
example: 0
description: Credits currently available
required:
- error
- required
- available
'500':
description: Internal Server Error - Service configuration or processing error
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Service configuration error
required:
- error
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: |-
API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
Get your API key from the [Dashboard](https://sociavault.com/dashboard).
````