{"uid":"cap_-rw65J5OtzXkKq-kPfRym","slug":"tiktok-video-comments-fetcher-83c99af9","name":"TikTok Video Comments Fetcher","description":"Get the top-level comments on a video, in TikTok's default order, by video URL or numeric video ID.","url":"https://x402.apidirect.io/v1/tiktok/video/comments?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"url":{"type":"string","maxLength":500,"description":"TikTok video URL, e.g. https://www.tiktok.com/@tiktok/video/7516594811734854943 (max 500 characters). Short links are accepted. Provide exactly one of url or video_id."},"pages":{"type":"integer","default":1,"maximum":1000,"minimum":1,"description":"Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 50 comments."},"video_id":{"type":"string","description":"Numeric TikTok video ID: the number at the end of a video URL. Provide exactly one of url or video_id."},"get_sentiment":{"type":"boolean","default":false,"description":"Set to true to add AI emotion analysis to each item. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any item t"}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SMabcgEtbta9ViQ7mRvc-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves top-level comments on a TikTok video (by URL or numeric ID) in TikTok's default order, with optional AI sentiment analysis.","exampleAgentPrompt":"Can you pull the first 3 pages of comments from this TikTok video — https://www.tiktok.com/@tiktok/video/7516594811734854943 — and include the AI sentiment analysis on each comment so I can see what emotions people are expressing?","exampleUseCases":[{"title":"Brand sentiment monitoring on viral video","prompt":"Grab the top 2 pages of comments from this TikTok video https://www.tiktok.com/@nike/video/7516594811734854943 and include sentiment analysis — I want to know whether people are reacting positively or negatively to our new product launch."},{"title":"Research audience reaction for content strategy","prompt":"Fetch the first page of comments from TikTok video ID 7516594811734854943 so I can see what people are saying and use it to plan our next content direction."},{"title":"Competitor content engagement analysis","prompt":"Pull 5 pages of comments from this TikTok URL https://www.tiktok.com/@competitor/video/7512345678901234567 with sentiment scoring — I want to understand the emotional tone of the audience engaging with my competitor's top video."}],"resultDescription":"Returns a list of top-level comments on the specified TikTok video in TikTok's default sort order, with up to 50 comments per page. Each comment includes commenter information and comment text. If sentiment analysis is enabled, each comment also includes an emotions breakdown (joy, trust, fear, surprise, sadness, disgust, anger, anticipation — each scored 0–100), a dominant emotion, emotional intensity (0–10), and polarity (positive, negative, or neutral).","failureModes":["Invalid or expired TikTok video URL returns an error or empty result","Both url and video_id provided simultaneously may cause a conflict or be rejected","Private or deleted TikTok videos may return no comments or an access error","Requesting too many pages for a video with few comments may return partial results","Rate limiting or payment failure (x402) may block the request","Short links that fail to resolve return no data"],"whenToPreferThis":"Choose this endpoint when you need to extract comments from a specific TikTok video by URL or numeric ID, especially when you want TikTok's default comment ordering and optional AI emotion analysis per comment. It is the right choice for brand monitoring, sentiment research, audience analysis, and social listening workflows targeting TikTok content. Prefer it over general web scraping when you need structured comment data with optional sentiment enrichment in a single API call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:21.341Z","isFirstParty":false,"canonicalSlug":"tiktok-video-comments-fetcher-83c99af9"}