Fetch TikTok video comments on-demand for $0.06 per request via pay-per-call API.
What it does
This endpoint retrieves comments on a specific TikTok video. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit (36 endpoints total). Every call costs a flat $0.06 USD, settled via USDC on Base, Solana, or Tempo (MPP/x402). No API keys or subscriptions are required — payment itself serves as authentication.
The workflow is asynchronous: you POST to `/api/tiktok/post-comments` with a `profile_id` (TikTok username) and `post_id` (video ID), along with optional parameters like `max_comments` (up to 300), `order_by`, `max_page_size`, and a pagination `cursor`. On success the endpoint returns HTTP 202 with a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth proving you are the paying wallet) until the job status is "finished" and your comment data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes.
This endpoint depends on prior data collection: you should first trigger `/api/tiktok/profile` for the user, then `/api/tiktok/posts` to collect their videos, before requesting comments on a specific post. Pagination is supported — each subsequent page requires a new paid POST with the cursor from the previous response's `page_info`. If the trigger POST itself fails (e.g., invalid parameters), you are not charged.
Capabilities
Use cases
- —Sentiment analysis on TikTok video comments for brand monitoring
- —Collecting audience feedback and reactions on viral TikTok content
- —Competitive analysis by comparing comment volumes and themes across creators
- —Building datasets of TikTok engagement data for research
- —Automated social listening pipelines that track comment trends over time
Fit
Best for
- —AI agents needing on-demand TikTok comment data without managing API keys
- —Researchers collecting TikTok engagement data at scale with simple per-request pricing
- —Social media monitoring tools that need comment-level data from specific videos
Not for
- —Real-time streaming of comments as they are posted (this is async polling, not a live feed)
- —Bulk historical archival of millions of comments (each page costs $0.06 and max 300 comments per job)
- —Use cases requiring official TikTok API compliance or OAuth-based user authorization
Quick start
# Step 1: Trigger comment collection (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/tiktok/post-comments \
-H 'Content-Type: application/json' \
-d '{"profile_id": "charlidamelio", "post_id": "7234567890123456789", "max_comments": 50}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
-H 'SIGN-IN-WITH-X: <siwx_token>'Example
Request
{
"post_id": "7234567890123456789",
"order_by": "date_desc",
"profile_id": "charlidamelio",
"max_comments": 50,
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance documentation, and explicit pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No response schema is documented (only "Successful response"), and no example response body for the actual comment data is provided, which limits completeness.
Warnings
- —Endpoint returned 405 on HEAD and GET probes — this is expected since it only accepts POST with a payment header, but the probe marks it as not live. The endpoint is likely live based on the full OpenAPI spec and landing page.
- —No response schema is defined in the OpenAPI spec — the actual structure of returned comment data is undocumented.
- —This endpoint has a dependency chain: you must first call /api/tiktok/profile and /api/tiktok/posts before comments can be retrieved.
- —SIWX wallet authentication is required for polling results, which adds integration complexity beyond the payment step.
Citations
- —Every endpoint costs $0.06 per request, settled in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The workflow is async: POST returns 202 with a JWT token, then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —post-comments endpoint requires profile_id and post_id, supports max_comments up to 300, order_by, pagination cursorhttps://stablesocial.dev/openapi.json
- —This endpoint depends on prior profile and posts collectionhttps://stablesocial.dev
- —If the POST trigger fails, you are not charged — payment only settles on 2xx responseshttps://stablesocial.dev
- —StableSocial covers 4 platforms with 36 endpoints totalhttps://stablesocial.dev