SocialCrawl
Scrape

Read comments and replies

See where comments, replies and comment search exist, and which call to use on each platform

Each platform that shows comments has its own call for them, and most have one for replies too. This page lists them, shows how to price one for free, and points to the call that reads many posts at once.

Price a comments call for free

Ask for the price of a call before you send it. The estimate takes the endpoint's id and the same parameters, costs nothing and creates nothing.

cURL
curl -G "https://www.socialcrawl.dev/v1/utility/estimate" \
  -H "x-api-key: sc_your_key_here" \
  --data-urlencode "id=youtube/video/comments" \
  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Response (trimmed)
{
  "success": true,
  "data": {
    "id": "youtube/video/comments",
    "valid": true,
    "hold": 1,
    "expected_min": 1,
    "expected_max": 1,
    "pricing": "metered",
    "levers": [
      { "param": "label", "hold": 5, "effect": "label=spam raises the hold to 5 credits." }
    ]
  },
  "credits_used": 0
}

hold is what the call reserves before it runs. levers names the options that change the price. A call that fails is refunded.

Which call reads comments?

Every endpoint whose job is comments or replies, with its price per call:

Comment and reply endpoints
PlatformEndpointPathCredits
DouyinGet replies to a Douyin comment/v1/douyin/comment/replies5-250 (metered)
DouyinGet Douyin video comments/v1/douyin/post/comments2-100 (metered)
FacebookList replies to a Facebook post comment/v1/facebook/post/comment/replies1-5 (metered)
FacebookList Facebook post comments/v1/facebook/post/comments1-5 (metered)
GabList the comments on a Gab post/v1/gab/post/comments1
GitHubGet comments on an issue or pull request/v1/github/issue/comments1
GoodreadsList the comments under a Goodreads review/v1/goodreads/review/comments1
Hacker NewsGet comments on a Hacker News story/v1/hackernews/story/comments1
InstagramLook up one Instagram comment by URL or id/v1/instagram/comment5-15 (metered)
InstagramList the accounts that liked an Instagram comment/v1/instagram/comment/likers1
InstagramList replies under an Instagram comment/v1/instagram/post/comment/replies1-5 (metered)
InstagramList Instagram post comments/v1/instagram/post/comments5-19 (metered)
LinkedInList comments on a LinkedIn Pulse article/v1/linkedin/article/comments5
LinkedInGet LinkedIn post comments/v1/linkedin/post/comments5
LinkedInList replies to a LinkedIn comment/v1/linkedin/post/comments/replies5
LinkedInGet a LinkedIn post together with its comments/v1/linkedin/post/with-comments5
LinkedInList a member's comments/v1/linkedin/profile/comments5
PrismBuyer leads from the comments under the posts a keyword search returns, opening only the posts worth opening./v1/prism/comment-leads0-243 (metered)
PrismRe-check up to 25 known comments in one call: per-item results, failed items refunded./v1/prism/comment-lookup2-100 (metered)
PrismEvery comment on a post, replies nested, server-paginated to completion./v1/prism/comments2-200 (metered)
PrismUp to 25 post URLs across platforms → each post's comments in one call, priced per page like the comment endpoints./v1/prism/post-comments1-2500 (metered)
PrismNew comments on a profile's recent posts, in one list, newest first./v1/prism/profile/comments2-2428 (metered)
Product HuntList the comments on a Product Hunt launch/v1/producthunt/product/comments1
RedditList Reddit post comments/v1/reddit/post/comments5-9 (metered)
RedditRead a Reddit account's own comment history, newest first, deeper than any search index reaches. Metered: 2 credits per comment returned, so try /v1/reddit/search/comments?query=author:name first/v1/reddit/profile/comments2-200 (metered)
RedditSearch Reddit comments/v1/reddit/search/comments1-5 (metered)
RumbleList top-level comments on a Rumble video/v1/rumble/video/comments1
SnapchatList comments on a Snapchat Spotlight/v1/snapchat/spotlight/comments1
Stack OverflowGet the comments on a Stack Overflow question/v1/stackoverflow/question/comments1
ThreadsGet comments on a Threads post/v1/threads/post/comments1-10 (metered)
TikTokLook up one TikTok comment by URL or id/v1/tiktok/comment2-6 (metered)
TikTokList TikTok post comments/v1/tiktok/post/comments1-7 (metered)
TikTokList TikTok comment replies/v1/tiktok/video/comment/replies1-5 (metered)
Twitter/XList Twitter tweet replies/v1/twitter/tweet/replies1-5 (metered)
WeiboList the replies to a Weibo comment/v1/weibo/comment/replies5
WeiboList the comments on a Weibo post/v1/weibo/post/comments5
XiaohongshuGet Xiaohongshu note comments/v1/xiaohongshu/post/comments5-100 (metered)
YouTubeList YouTube comment replies/v1/youtube/video/comment/replies1-5 (metered)
YouTubeList YouTube video comments/v1/youtube/video/comments1-5 (metered)

Read one post's comments and replies

Send the post's URL to its platform's comments endpoint. Each response is one page, and pagination.next_cursor fetches the next.

cURL
curl -G "https://www.socialcrawl.dev/v1/youtube/video/comments" \
  -H "x-api-key: sc_your_key_here" \
  --data-urlencode "url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

Replies are a second call on most platforms. The replies endpoint in the table takes the comment, or the token the comments response gave for it. To get both in one request, use GET /v1/prism/comments. It walks the thread and nests each comment's replies under it. Reddit and Hacker News always return the whole nested thread.

Can I search comments?

Reddit has its own comment search, GET /v1/reddit/search/comments. On X a reply is a post, so GET /v1/twitter/search/tweets finds replies along with other posts. Instagram and TikTok have no comment search. To find what people say under posts about a topic on those platforms, read the comments of the posts a search found. Discover does that in one run.

Comments from many posts at once

POST /v1/prism/post-comments takes a list of post URLs from several platforms and returns each post's comments in one call. The comments in bulk cookbook walks through it and turns it into a poll for new comments only. For a long list of one platform's calls, background jobs run them for you.

How do I read the reply counters on a comments response?

Each entry in data.comments from GET /v1/prism/comments is { comment, replies }. The replies sit in the replies array beside their comment and never appear as separate entries. The counters count like this:

  • total_fetched is the top-level comments scanned, before any limit.
  • returned is the top-level comments in comments.
  • replies_returned is the replies nested under those comments.
  • parents_expanded is how many comments carry at least one reply.
  • completed is true when the whole thread was read. It is false when a limit or the time budget stopped the scan, and next_cursor then resumes it.
  • replies_truncated is on a single comment. It is true when that comment has more replies than were fetched.

The replies parameter nests the replies under every comment whose engagement.replies is above zero. It is on by default for TikTok, YouTube and Facebook. On Instagram it is off unless you send replies=true. Each replies call that returned replies costs 1 credit, and the walk covers up to 100 comments and 10 replies pages per comment in one call. Send replies=false when you only want the top comments. Reddit and Hacker News always return their whole nested thread.

cURL
curl "https://www.socialcrawl.dev/v1/prism/comments?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&replies=true&sort=top&max=100" \
  -H "x-api-key: sc_your_key_here"

Next steps