# TikTok Comments API Beta Returns the public top-level comments of a TikTok video or photo post, a page at a time, in TikTok's own ranking: text, exact posting time, exact like and reply counts, the commenter's username, name, ID and verified badge, the comment's language, and whether it is pinned, liked by the creator or written by the creator. Follow page.next_cursor for more. Accepts tiktok.com video and photo links, mobile, embed and player URLs, vm./vt./t/ share links, or a numeric video ID. [Get 100 free credits](https://staging.socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.comments) · [API reference](https://staging.socialtap.dev/docs/reference/tiktok/comments/index.md) · [Try it](https://staging.socialtap.dev/playground/?endpoint=tiktok.comments) - **Price**: From **1 credit** per page$0.75–$1.45 per 1,000 pages - **Request**: `GET /v1/tiktok/comments`One API key, one JSON schema - **Input**: `url`e.g. `https://www.tiktok.com/@scout2015/video/6718335390845095173` - **Page size**: Up to 50 comments Use cases ## What teams build with it. From one request. - Track audience sentiment on your videos and competitors' - Find questions and purchase intent in comments - Measure engagement beyond likes and views - Build datasets of public comments for research What you get ## Comments in one schema. The same on every platform. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native comment ID (string; Reddit without t1_). - **`post_id`string**: ID of the post commented on (equals post.id). - **`parent_id`string**: ID of the comment this replies to; null for top-level comments. - **`url`string**: Permalink, when the platform has one. - **`text`string**: Comment body as plain text. - **`author`object**: The commenting account. - **`published_at`string**: When the comment was posted, RFC 3339 UTC. Where the platform shows only a relative time ("3 weeks ago"), the latest time that label allows (the fetch time minus the stated amount), listed in approximate_fields. Every field, its type and when it is `null`: [the response reference](https://staging.socialtap.dev/docs/reference/tiktok/comments/index.md#response) and the [comment schema](https://staging.socialtap.dev/resources/comment/index.md). ## Example request cURL: ```shell curl -G 'https://staging.socialtap.dev/v1/tiktok/comments' \ --data-urlencode 'url=https://www.tiktok.com/@scout2015/video/6718335390845095173' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` Node.js: ```javascript const params = new URLSearchParams({ url: "https://www.tiktok.com/@scout2015/video/6718335390845095173", }); const res = await fetch(`https://staging.socialtap.dev/v1/tiktok/comments?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python: ```python import os import requests res = requests.get( "https://staging.socialtap.dev/v1/tiktok/comments", params={"url": "https://www.tiktok.com/@scout2015/video/6718335390845095173"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go: ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("url", "https://www.tiktok.com/@scout2015/video/6718335390845095173") req, err := http.NewRequest("GET", "https://staging.socialtap.dev/v1/tiktok/comments?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "author": { "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7336370956674203653~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=8c568077&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5", "display_name": "flamigoo", "id": "6650133637952618502", "is_verified": false, "url": "https://www.tiktok.com/@flamigo_kisses", "username": "flamigo_kisses" }, "edited_at": null, "id": "6718335906996502534", "is_by_post_author": false, "is_edited": null, "is_liked_by_author": false, "is_pinned": false, "metrics": { "like_count": 166, "reply_count": 49 }, "parent_id": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": null } }, "post_id": "6718335390845095173", "published_at": "2019-07-27T13:34:35Z", "text": "ok ;)\nodoreta\nhave fun~\n(it's a Serbian name)", "unknown_fields": [], "url": "https://m.tiktok.com/v/6718335390845095173.html?share_comment_id=6718335906996502534&share_item_id=6718335390845095173" }, { "approximate_fields": [], "author": { "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7331407432645509126~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=0687ce2b&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5", "display_name": "vsco_room_xx", "id": "6718326650415203333", "is_verified": false, "url": "https://www.tiktok.com/@vsco_room_xx", "username": "vsco_room_xx" }, "edited_at": null, "id": "6722043930156417030", "is_by_post_author": false, "is_edited": null, "is_liked_by_author": false, "is_pinned": false, "metrics": { "like_count": 53, "reply_count": 44 }, "parent_id": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": null } }, "post_id": "6718335390845095173", "published_at": "2019-08-06T13:23:37Z", "text": "srii good luck", "unknown_fields": [], "url": "https://m.tiktok.com/v/6718335390845095173.html?share_comment_id=6722043930156417030&share_item_id=6718335390845095173" }, { "approximate_fields": [], "author": { "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-maliva-avt-0068/7328085019259748357~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=50158ea6&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5", "display_name": "Quit", "id": "6627564337508761605", "is_verified": false, "url": "https://www.tiktok.com/@pretzelsticks0", "username": "pretzelsticks0" }, "edited_at": null, "id": "6718336105873702917", "is_by_post_author": false, "is_edited": null, "is_liked_by_author": true, "is_pinned": false, "metrics": { "like_count": 345, "reply_count": 20 }, "parent_id": null, "platform": "tiktok", "platform_specific": { "tiktok": { "language": null } }, "post_id": "6718335390845095173", "published_at": "2019-07-27T13:35:22Z", "text": "Well it’s pretty easy...and obvious 😂 hlysa", "unknown_fields": [], "url": "https://m.tiktok.com/v/6718335390845095173.html?share_comment_id=6718336105873702917&share_item_id=6718335390845095173" } ], "page": { "has_more": true, "next_cursor": "c1.EXAMPLE_CURSOR", "next_cursor_expires_at": "2026-10-26T12:00:00Z", "end_reason": null }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "tiktok", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 0, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "video", "id": "6718335390845095173", "url": "https://www.tiktok.com/@/video/6718335390845095173" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [], "mode": "live" } } ``` Long arrays and strings are shortened for display; real responses are complete. > [!NOTE] > > **Good to know** > > - TikTok ranks comments itself and has no newest-first order, so since and until are not offered; published_at is exact for filtering on your side. > - Pages can hold fewer comments than limit while more follow, and TikTok repeats some comments across the first pages of a busy video: deduplicate by id. > - Replies are not included; metrics.reply_count says how many a comment has. > - Private videos and videos with comments turned off return private_or_unavailable; deleted videos return not_found, though TikTok keeps serving the comments of some deleted videos, which are then returned. Pricing ## Pay per page. Only when it succeeds. | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.45 | - Failed requests are free: errors cost 0 credits. - Cache hits are free: responses served from the cache cost 0 credits. - Credits never expire. - One credit balance for every endpoint and platform. [Credit packs](https://staging.socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://staging.socialtap.dev/docs/reference/tiktok/comments/index.md#pricing) · [How credits work](https://staging.socialtap.dev/docs/credits/index.md) FAQ ## Questions, answered. **How much does the TikTok Comments API cost?** 1 credit for platform api results (meta.source = api) per page of up to 50 items, charged for every successful page, empty pages included. SocialTap credits cost $0.75–$1.45 per 1,000 depending on the pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more items. Cursors expire after 24 hours. **Am I charged for failed requests?** No. Requests that return an error cost 0 credits. Responses served from the cache are free too. Same schema, other platforms ## Comments everywhere. One parser. [YouTube Comments APIBetaComment`GET /v1/youtube/comments`1 credit / page](https://staging.socialtap.dev/apis/youtube/comments/index.md) More TikTok ## TikTok API. 5 endpoints, one key. [TikTok Post APIBetaPost`GET /v1/tiktok/post`1 credit](https://staging.socialtap.dev/apis/tiktok/post/index.md) · [TikTok Posts APIBetaPost`GET /v1/tiktok/posts`1 credit / page](https://staging.socialtap.dev/apis/tiktok/posts/index.md) · [TikTok Profile APIBetaProfile`GET /v1/tiktok/profile`1 credit](https://staging.socialtap.dev/apis/tiktok/profile/index.md) · [TikTok Transcript APIBetaTranscript`GET /v1/tiktok/transcript`From 1 credit](https://staging.socialtap.dev/apis/tiktok/transcript/index.md) ## Start with 100 free credits. No card required. Test keys answer every endpoint from recorded responses, free, so you can build before you spend. Failed requests are always free. [Get your API key](https://staging.socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.comments) · [Read the API reference](https://staging.socialtap.dev/docs/reference/tiktok/comments/index.md) --- [HTML version](https://staging.socialtap.dev/apis/tiktok/comments/) · [Docs index for AI agents](https://staging.socialtap.dev/llms.txt) · [All docs in one file](https://staging.socialtap.dev/llms-full.txt)