Comment leads
Questions and purchase-intent comments, structured.
Upstream
/aweme/v2/comment/list/Every planParameters
| Name | Type | Description |
|---|---|---|
aweme_idaweme_id or url | string | The numeric video ID. e.g. 7705852133855161377 |
urlaweme_id or url | string | A share link instead of an aweme_id: tiktok.com, vm.tiktok.com or vt.tiktok.com. |
Pricing
| Plan | Per call | Per 1,000 calls |
|---|---|---|
| Starter | 10 credits | $1.16 |
| Growth | 10 credits | $0.79 |
| Scale | 10 credits | $0.58 |
Response fields
| Field | Type | Description |
|---|---|---|
aweme_id | string | 64-bit TikTok Snowflake post ID (top 32 bits encode UTC creation timestamp). |
scanned_comments | integer | Decoded scanned comments value. |
blue_search_keywords | string[] | Decoded blue search keywords value. |
leads | object[] | List of leads objects. |
leads[].cid | string | 64-bit Snowflake comment ID. |
leads[].intent | string | Decoded intent value. |
leads[].score | number | Decoded score value. |
leads[].text | string | UTF-8 text body. |
leads[].user | object | Resolved user profile object. |
leads[].digg_count | integer | Like count on this item or comment. |
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/comment-leads", params={
"aweme_id": "7705852133855161377",
})
print(res.credits_cost, res.data){
"aweme_id": "7705852133855161377",
"scanned_comments": 100,
"blue_search_keywords": [
"low profile mechanical keyboard",
"acme 75 keyboard"
],
"leads": [
{
"cid": "7705860011122233344",
"intent": "purchase_question",
"score": 0.96,
"text": "Where is this keyboard from?",
"user": {
"unique_id": "kbfan"
},
"digg_count": 412
},
{
"cid": "7705860011122233349",
"intent": "price_inquiry",
"score": 0.91,
"text": "Do you ship to UK and how much is the tactile version?",
"user": {
"unique_id": "uk_dev"
},
"digg_count": 54
}
]
}More in Videos & comments
GET/v1/videoGet video5 crPOST/v1/video/batchBatch videos5 cr / itemGET/v1/video/commentsComments5 crGET/v1/video/comments/repliesComment replies5 crGET/v1/video/comments/by-idsComments by ID5 crGET/v1/video/danmakuExclusiveDanmaku5 crGET/v1/video/transcriptTranscript2 crGET/v1/video/no-watermarkNo-watermark media2 crGET/v1/video/slideshowSlideshow media2 crGET/v1/video/duetsDuets and stitches5 crGET/v1/video/anchorsVideo anchors5 crGET/v1/video/upvotesRepost annotations5 crGET/v1/video/share-infoShare info5 crGET/v1/video/giftsVideo gifts5 crGET/v1/video/forensicsVideo forensics10 crGET/v1/video/fyp-velocityFYP velocity10 cr
Ready to build?
Start with 2,500 free credits and test every public endpoint, then pick a plan.