Skip to content
Managed gateway · LeanPool

Comment leads

Questions and purchase-intent comments, structured.

GETapi.tikultra.com/v1/video/comment-leadsHeavy · 10 credits
Upstream/aweme/v2/comment/list/Every plan

Parameters

NameTypeDescription
aweme_idaweme_id or urlstringThe numeric video ID.
e.g. 7705852133855161377
urlaweme_id or urlstringA share link instead of an aweme_id: tiktok.com, vm.tiktok.com or vt.tiktok.com.

Pricing

PlanPer callPer 1,000 calls
Starter10 credits$1.16
Growth10 credits$0.79
Scale10 credits$0.58

Response fields

FieldTypeDescription
aweme_idstring64-bit TikTok Snowflake post ID (top 32 bits encode UTC creation timestamp).
scanned_commentsintegerDecoded scanned comments value.
blue_search_keywordsstring[]Decoded blue search keywords value.
leadsobject[]List of leads objects.
leads[].cidstring64-bit Snowflake comment ID.
leads[].intentstringDecoded intent value.
leads[].scorenumberDecoded score value.
leads[].textstringUTF-8 text body.
leads[].userobjectResolved user profile object.
leads[].digg_countintegerLike 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
    }
  ]
}
Try it in the playgroundFull reference in the docs

More in Videos & comments

Ready to build?

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