TikTok Video Comments API
Call GET /v1/tiktok/video/comments with a bearer key to get TikTok video comments — structured JSON, documented errors, and code samples in five languages.
- One REST Endpoint
- Simple Authentication
- Structured JSON Response
- Predictable Errors
- Cursor Pagination
- Idempotent Retries
Request examples
curl "https://api.agentbody.io/v1/tiktok/video/comments?video_id=7666863743514545422&limit=1&cursor=next-page-token" \
-H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"Response examples
Documented responses from the OpenAPI specification.
Successful Gateway result.
{
"has_more": false,
"items": [],
"next_cursor": "example_value"
}Features
Technical properties of the TikTok Video Comments API endpoint and how to integrate it.
One REST Endpoint
Call GET /v1/tiktok/video/comments with a bearer API key. The TikTok Video Comments API returns documented JSON — no SDK required, any HTTP client works.
Simple Authentication
Pass your key as a bearer token. Keep it server-side: the key never belongs in browser code, public repos, or client bundles.
Structured JSON Response
Responses use stable, documented field names so parsers, spreadsheets, and agent pipelines can consume results without custom cleanup.
Predictable Errors
400-class responses mean fix the request; 401 means check the key; 429 means slow down. Temporary 5xx failures are safe to retry with backoff.
Cursor Pagination
List-style responses include next_cursor and has_more. Pass the cursor back unchanged to fetch the next page — never construct or modify cursors.
Idempotent Retries
Send an idempotency key so a repeated request replays the stored response instead of executing and billing twice.
How to use
Integrate the TikTok Video Comments API in six steps: key, request, parse, handle errors, paginate, and monitor.
Create An API Key
Create an AgentBody account and generate a key in the console. Store it in your server environment or secret manager — never ship it to clients.
Build The Request
Send GET /v1/tiktok/video/comments with the required input (video_id). The samples on this page show the exact call in five languages.
Parse The Response
Read the documented JSON fields into your application. Store only what your product needs.
Handle Errors Explicitly
Fix 400s by correcting input, refresh 401s by rotating keys, and retry 5xx with exponential backoff. Treat validation failures as final answers, not transient faults.
Paginate With Cursors
When has_more is true, pass next_cursor unchanged on the next request until the window you need is covered.
Monitor Usage
Track calls and credits in the console. The usage endpoints let your own dashboard reflect consumption in real time.
Frequently asked questions
What is the TikTok Video Comments API?
An authenticated REST endpoint (GET /v1/tiktok/video/comments) that get TikTok video comments and returns structured JSON. One AgentBody key covers it and every other AgentBody endpoint.
How do I authenticate the TikTok Video Comments API?
Send an Authorization: Bearer header with your API key. Create and rotate keys in the console; keep them server-side only.
What does the TikTok Video Comments API response look like?
A successful call returns JSON with documented, stable field names. Full request and response examples appear on this page and in the linked documentation.
How much does the TikTok Video Comments API cost?
Each call consumes account credits. Pricing is governed by the gateway and visible in the console — this page never shows fixed numbers, so the console is always authoritative.
Does the TikTok Video Comments API support pagination?
List endpoints return next_cursor and has_more. Pass the cursor back unchanged to continue. Detail endpoints return a single object with no pagination.
Can agents call the TikTok Video Comments API directly?
Yes. Install the official AgentBody skill with the one-prompt install on the Agent tab, and your agent can call this endpoint — and every other AgentBody endpoint — with the same key.