# TikTok Comment API (https://www.socialcrawl.dev/platforms/tiktok/comment)

> Resolves a single TikTok comment to a live comment object (current like count, reply count, pinned flag, author, timestamp) without you paginating the comment section. Pass `comment_url` (a `.../@{handle}/video/{id}?comment_id={cid}` link, an `m.tiktok.com` share link, or a `vm.tiktok.com`/`.../t/` shortlink: resolved automatically) OR `post_url` + `comment_id`. For a reply, also pass `parent_comment_id` (a reply URL does not carry its parent). Instead of a comment id you can search the comment section: `author_username` (find a specific author's comments) or `text_contains` (exact snippet) return up to `max` matches under `data.matches` (a search that matches nothing returns 404 and is fully refunded). The response includes a `lookup.position_hint`: pass it back on a later lookup of the same comment to make the re-check faster (the price is the same). Flat 2 credits (6 with `deep_scan=true`, which widens the scan budget); a not-found returns 404 and is fully refunded.

TL;DR: `GET /v1/tiktok/comment` costs 2 credits for a standard lookup, 6 with `deep_scan=true`, which keeps paging the thread when the comment is not in the first pages. Reach for deep_scan only after a standard lookup comes back not-found and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `comment_url` | no | A TikTok comment URL: `https://www.tiktok.com/@{handle}/video/{videoId}?comment_id={cid}`, the `m.tiktok.com/v/{id}.html?...&share_comment_id={cid}` share form, or a `vm.tiktok.com/{code}` / `tiktok.com/t/{code}` shortlink. The `cid`/`comment_id`/`share_comment_id` query value may be numeric or the base64 form TikTok's share sheet emits (`?cid=NzY1...`): both are accepted; base64 is decoded automatically. Mutually exclusive with `post_url`+`comment_id`. |
| `post_url` | no | The post URL (`https://www.tiktok.com/@{handle}/video/{videoId}`). Combine with `comment_id`, or with `author_username`/`text_contains` for a search. |
| `comment_id` | no | The target comment's numeric id (the `cid` from the comments endpoint). Requires `post_url`. Note that TikTok share links carry a base64-encoded `cid`: pass such a link as `comment_url` instead (decoded automatically), or base64-decode the value to its digits before passing it here. |
| `parent_comment_id` | no | The parent comment's numeric id: supply this when the target is a reply so it can be resolved directly via the native replies endpoint. |
| `author_username` | no | Return up to `max` comments authored by this username (no comment id needed). Mutually exclusive with `text_contains` and any comment id. |
| `text_contains` | no | Return up to `max` comments whose text contains this snippet (case-insensitive). Mutually exclusive with `author_username` and any comment id. |
| `deep_scan` | no | Widen the scan budget for deeply-buried comments (raises the page ceiling and deadline). Bills 6 credits instead of 2. |
| `position_hint` | no | Opaque token from a prior lookup's `lookup.position_hint`. Passing it back probes the comment's last-known location first, making a re-check of an already-found comment cheap. |
| `max` | no | For `author_username`/`text_contains` search: max matches to return (1-20, default 5). |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/comment" \
  --data-urlencode "comment_url=https://www.tiktok.com/@mrbeast/video/7654638524729216287?comment_id=7654640784985211670" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I look up a single TikTok comment with an API?

Send a GET request to /v1/tiktok/comment with comment_url, or with post_url plus comment_id. Comment links, m.tiktok.com share links and vm.tiktok.com shortlinks are all resolved, and base64 cid values from the share sheet are decoded automatically.

### Can I check a TikTok comment's likes without paging every comment?

Yes. The endpoint returns the comment's current like count, reply count, pinned flag, author and timestamp, so you can re-check one known comment instead of paging /v1/tiktok/post/comments.

### Can I find a TikTok comment without its id?

Yes. Pass post_url with author_username to find one author's comments, or with text_contains to match an exact snippet, and up to max matches (1 to 20, default 5) come back under data.matches. A search that matches nothing returns a 404 and is fully refunded.

### How much does the TikTok comment API cost?

A standard lookup costs 2 credits and a lookup with deep_scan=true costs 6, because it keeps paging the thread when the comment is buried. A not-found returns a 404 and is fully refunded, so try deep_scan only after a standard lookup misses.

### How do I look up a reply to a TikTok comment?

Pass parent_comment_id along with the reply's id, because a reply URL does not carry its parent. The response also includes lookup.position_hint, and sending it back on a later check of the same comment makes the re-check faster at the same price.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How can I check the like count of one TikTok comment with SocialCrawl?
- Does SocialCrawl have an API to look up a TikTok comment by id?