# Comments and replies (/docs/comments) 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. ```bash title="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" ``` ```json title="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: | Platform | Endpoint | Path | Credits | | --- | --- | --- | --- | | Douyin | [Get replies to a Douyin comment](/platforms/douyin/comment-replies) | `/v1/douyin/comment/replies` | 5-250 (metered) | | Douyin | [Get Douyin video comments](/platforms/douyin/post-comments) | `/v1/douyin/post/comments` | 2-100 (metered) | | Facebook | [List replies to a Facebook post comment](/platforms/facebook/post-comment-replies) | `/v1/facebook/post/comment/replies` | 1-5 (metered) | | Facebook | [List Facebook post comments](/platforms/facebook/post-comments) | `/v1/facebook/post/comments` | 1-5 (metered) | | Gab | [List the comments on a Gab post](/platforms/gab/post-comments) | `/v1/gab/post/comments` | 1 | | GitHub | [Get comments on an issue or pull request](/platforms/github/issue-comments) | `/v1/github/issue/comments` | 1 | | Goodreads | [List the comments under a Goodreads review](/platforms/goodreads/review-comments) | `/v1/goodreads/review/comments` | 1 | | Hacker News | [Get comments on a Hacker News story](/platforms/hackernews/story-comments) | `/v1/hackernews/story/comments` | 1 | | Instagram | [Look up one Instagram comment by URL or id](/platforms/instagram/comment) | `/v1/instagram/comment` | 5-15 (metered) | | Instagram | [List the accounts that liked an Instagram comment](/platforms/instagram/comment-likers) | `/v1/instagram/comment/likers` | 1 | | Instagram | [List replies under an Instagram comment](/platforms/instagram/post-comment-replies) | `/v1/instagram/post/comment/replies` | 1-5 (metered) | | Instagram | [List Instagram post comments](/platforms/instagram/post-comments) | `/v1/instagram/post/comments` | 5-19 (metered) | | LinkedIn | [List comments on a LinkedIn Pulse article](/platforms/linkedin/article-comments) | `/v1/linkedin/article/comments` | 5 | | LinkedIn | [Get LinkedIn post comments](/platforms/linkedin/post-comments) | `/v1/linkedin/post/comments` | 5 | | LinkedIn | [List replies to a LinkedIn comment](/platforms/linkedin/post-comments-replies) | `/v1/linkedin/post/comments/replies` | 5 | | LinkedIn | [Get a LinkedIn post together with its comments](/platforms/linkedin/post-with-comments) | `/v1/linkedin/post/with-comments` | 5 | | LinkedIn | [List a member's comments](/platforms/linkedin/profile-comments) | `/v1/linkedin/profile/comments` | 5 | | Prism | [Buyer leads from the comments under the posts a keyword search returns, opening only the posts worth opening.](/platforms/prism/comment-leads) | `/v1/prism/comment-leads` | 0-243 (metered) | | Prism | [Re-check up to 25 known comments in one call: per-item results, failed items refunded.](/platforms/prism/comment-lookup) | `/v1/prism/comment-lookup` | 2-100 (metered) | | Prism | [Every comment on a post, replies nested, server-paginated to completion.](/platforms/prism/comments) | `/v1/prism/comments` | 2-200 (metered) | | Prism | [Up to 25 post URLs across platforms → each post's comments in one call, priced per page like the comment endpoints.](/platforms/prism/post-comments) | `/v1/prism/post-comments` | 1-2500 (metered) | | Prism | [New comments on a profile's recent posts, in one list, newest first.](/platforms/prism/profile-comments) | `/v1/prism/profile/comments` | 2-2428 (metered) | | Product Hunt | [List the comments on a Product Hunt launch](/platforms/producthunt/product-comments) | `/v1/producthunt/product/comments` | 1 | | Reddit | [List Reddit post comments](/platforms/reddit/post-comments) | `/v1/reddit/post/comments` | 5-9 (metered) | | Reddit | [Read 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](/platforms/reddit/profile-comments) | `/v1/reddit/profile/comments` | 2-200 (metered) | | Reddit | [Search Reddit comments](/platforms/reddit/search-comments) | `/v1/reddit/search/comments` | 1-5 (metered) | | Rumble | [List top-level comments on a Rumble video](/platforms/rumble/video-comments) | `/v1/rumble/video/comments` | 1 | | Snapchat | [List comments on a Snapchat Spotlight](/platforms/snapchat/spotlight-comments) | `/v1/snapchat/spotlight/comments` | 1 | | Stack Overflow | [Get the comments on a Stack Overflow question](/platforms/stackoverflow/question-comments) | `/v1/stackoverflow/question/comments` | 1 | | Threads | [Get comments on a Threads post](/platforms/threads/post-comments) | `/v1/threads/post/comments` | 1-10 (metered) | | TikTok | [Look up one TikTok comment by URL or id](/platforms/tiktok/comment) | `/v1/tiktok/comment` | 2-6 (metered) | | TikTok | [List TikTok post comments](/platforms/tiktok/post-comments) | `/v1/tiktok/post/comments` | 1-7 (metered) | | TikTok | [List TikTok comment replies](/platforms/tiktok/video-comment-replies) | `/v1/tiktok/video/comment/replies` | 1-5 (metered) | | Twitter/X | [List Twitter tweet replies](/platforms/twitter/tweet-replies) | `/v1/twitter/tweet/replies` | 1-5 (metered) | | Weibo | [List the replies to a Weibo comment](/platforms/weibo/comment-replies) | `/v1/weibo/comment/replies` | 5 | | Weibo | [List the comments on a Weibo post](/platforms/weibo/post-comments) | `/v1/weibo/post/comments` | 5 | | Xiaohongshu | [Get Xiaohongshu note comments](/platforms/xiaohongshu/post-comments) | `/v1/xiaohongshu/post/comments` | 5-100 (metered) | | YouTube | [List YouTube comment replies](/platforms/youtube/video-comment-replies) | `/v1/youtube/video/comment/replies` | 1-5 (metered) | | YouTube | [List YouTube video comments](/platforms/youtube/video-comments) | `/v1/youtube/video/comments` | 1-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. ```bash title="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](/docs/engines/discover.md) 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](/docs/recipes/comments-in-bulk.md) 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](/docs/async.md) 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. ```bash title="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 - [Comments in bulk](/docs/recipes/comments-in-bulk.md): Read the comments under many posts and poll for new ones. - [Get every row](/docs/pagination.md): Walk a comments list to its end with the cursor. - [Labels](/docs/labels.md): Sentiment and other labels on each comment.