{ "openapi": "3.0.1", "info": { "title": "TikTok Comments Analyzer (AI)", "description": "Turn TikTok comments into a creator-ready report: audience mood weighted by likes, top questions as a ready FAQ, unanswered questions, buying intent, complaints, spam share and reply drafts. Use a TikTok Comments Scraper dataset or video URLs. $0.80 per 1,000 comments, $0.05 per report. Free demo.", "version": "0.1", "x-build-id": "QmAlGGnBCMRUopcgd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalsift~tiktok-comments-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalsift-tiktok-comments-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalsift~tiktok-comments-analyzer/runs": { "post": { "operationId": "runs-sync-signalsift-tiktok-comments-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalsift~tiktok-comments-analyzer/run-sync": { "post": { "operationId": "run-sync-signalsift-tiktok-comments-analyzer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "videoUrls": { "title": "TikTok video URLs", "type": "array", "description": "TikTok video links (Share → Copy link). Short vm.tiktok.com links work too. We scrape their comments with TikTok Comments Scraper on your account first (billed by that Actor), then analyze them. Leave empty if you give a dataset ID instead.", "default": [], "items": { "type": "string" } }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Comments to scrape per video, replies included. 1 to 20,000.", "default": 500 }, "maxRepliesPerComment": { "title": "Max replies per comment", "minimum": 0, "maximum": 50, "type": "integer", "description": "Replies to scrape under each comment. They count toward the per-video limit, and TikTok may return fewer. 0 to 50.", "default": 0 }, "yourUsername": { "title": "Your other TikTok accounts", "type": "string", "description": "The video's creator is recognised from the video link, and their comments are left out of the audience numbers, reply drafts and charges. Add other accounts of yours here, separated by commas. Used only for matching; never saved in the results." }, "maxComments": { "title": "Max comments to analyze", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Total cap for this run. Your spending limit can lower it further.", "default": 5000 }, "commentsSince": { "title": "Only comments posted since", "type": "string", "description": "Analyze only comments posted since this date, for example 2026-01-01. The scraper still scrapes (and bills) the comments per video." }, "draftReplies": { "title": "Draft replies to questions and complaints", "type": "boolean", "description": "Write a short, friendly reply draft (within TikTok's 150 characters) for the most liked questions and complaints the creator has not answered yet.", "default": true }, "maxReplyDrafts": { "title": "Max reply drafts", "minimum": 0, "maximum": 100, "type": "integer", "description": "Most liked unanswered questions and complaints to draft replies for. 0 to 100.", "default": 25 }, "reportLanguage": { "title": "Theme name language", "type": "string", "description": "Language for theme names, as a code such as en, de or es. Report headings are in English; quotes stay in each comment's own language.", "default": "en" }, "datasetId": { "title": "Dataset ID", "type": "string", "description": "ID of a dataset produced by TikTok Comments Scraper (clockworks/tiktok-comments-scraper). When this Actor runs as an integration after that scraper, the dataset is passed automatically." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }