Managed gateway · LeanPool

Comments by ID

Look up comments by their IDs.

GETapi.tikultra.com/v1/video/comments/by-idsStandard · 5 credits

Upstream/tiktok/comment/status/batch_get/v1Every plan

Parameters

Name	Type	Description
`comment_ids`required	string	Comma-separated comment IDs, up to 50. e.g. 7705860011122233344

Pricing

Plan	Per call	Per 1,000 calls
Starter	5 credits	$0.58
Growth	5 credits	$0.40
Scale	5 credits	$0.29

Response fields

Field	Type	Description
`status_code`	integer	Upstream TikTok mobile status code (0 indicates success).
`requested_count`	integer	Total requested count.
`items`	object[]	Page of normalized records returned by this endpoint.
`items[].cid`	string	64-bit Snowflake comment ID.
`items[].aweme_id`	string	64-bit TikTok Snowflake post ID (top 32 bits encode UTC creation timestamp).
`items[].status`	integer	Current lifecycle or health status.
`items[].text`	string	UTF-8 text body.
`items[].create_time`	integer	Unix timestamp (seconds) when the item was created.
`items[].digg_count`	integer	Like count on this item or comment.
`log_pb`	object	Upstream request trace envelope from the mobile gateway.
`log_pb.impr_id`	string	Upstream TikTok impression / trace identifier.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

import os
from tikultra import TikUltra

with TikUltra(api_key=os.environ["TIKULTRA_KEY"]) as client:
    res = client.request("GET", "/v1/video/comments/by-ids", params={
        "comment_ids": "7705860011122233344",
    })
    print(res.credits_cost, res.data)

{
  "status_code": 0,
  "requested_count": 1,
  "items": [
    {
      "cid": "7705860011122233344",
      "aweme_id": "7705852133855161377",
      "status": 1,
      "text": "Where is this keyboard from?",
      "create_time": 1794159100,
      "digg_count": 412,
      "reply_comment_total": 9,
      "comment_language": "en",
      "user": {
        "uid": "6970000000000000002",
        "sec_uid": "MS4wLjABAAAAkbfan991xQp2mN8vR4wL7tH3zK5y",
        "unique_id": "kbfan",
        "nickname": "KB Fan"
      }
    }
  ],
  "log_pb": {
    "impr_id": "202611120200419F8E7D6C5B4A3210"
  }
}

Try it in the playground Full reference in the docs

More in Videos & comments

GET/v1/videoGet video5 cr POST/v1/video/batchBatch videos5 cr / item GET/v1/video/commentsComments5 cr GET/v1/video/comments/repliesComment replies5 cr GET/v1/video/danmakuExclusiveDanmaku5 cr GET/v1/video/transcriptTranscript2 cr GET/v1/video/no-watermarkNo-watermark media2 cr GET/v1/video/slideshowSlideshow media2 cr GET/v1/video/duetsDuets and stitches5 cr GET/v1/video/anchorsVideo anchors5 cr GET/v1/video/upvotesRepost annotations5 cr GET/v1/video/share-infoShare info5 cr GET/v1/video/giftsVideo gifts5 cr GET/v1/video/forensicsVideo forensics10 cr GET/v1/video/fyp-velocityFYP velocity10 cr GET/v1/video/comment-leadsComment leads10 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing