{ "openapi": "3.0.1", "info": { "title": "TikTok Comments Scraper – No Login", "description": "Collect public TikTok comments and replies from video URLs. Export comment text, likes, timestamps and public author details in structured results. Set limits for comments, replies and total results, and pay only $0.50 per 1,000 saved comments or replies. No login is required.", "version": "0.2", "x-build-id": "7OcWgBI3LTOnObPss" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~tiktok-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-tiktok-comments-scraper", "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/datascraperes~tiktok-comments-scraper/runs": { "post": { "operationId": "runs-sync-datascraperes-tiktok-comments-scraper", "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/datascraperes~tiktok-comments-scraper/run-sync": { "post": { "operationId": "run-sync-datascraperes-tiktok-comments-scraper", "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", "required": [ "videoUrls" ], "properties": { "videoUrls": { "title": "TikTok video URLs or IDs", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Use a public TikTok video URL or numeric video ID. Short share URLs, profile URLs and private videos are not accepted.", "items": { "type": "string", "minLength": 1, "pattern": "^(?:[0-9]{10,25}|https?://(?:(?:www|m)\\.)?tiktok\\.com/(?:@[A-Za-z0-9._-]{1,64}/)?video/[0-9]{10,25}/?(?:[?#][^\\s]*)?)$" } }, "maxCommentsPerVideo": { "title": "Maximum top-level comments per video", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of top-level comments to collect from each video. The endpoint may return fewer comments than requested.", "default": 20 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Fetch public replies for each collected top-level comment. Replies use the same per-comment charge and are bounded by the reply limit.", "default": false }, "maxRepliesPerComment": { "title": "Maximum replies per comment", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum public replies to fetch for each top-level comment when replies are enabled. Set 0 to disable reply requests.", "default": 10 }, "maxTotalComments": { "title": "Maximum saved comments and replies in this run", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Hard run-wide limit across top-level comments and replies. Each saved row uses one comment PPE event and this limit protects cost and runtime for large batches.", "default": 100 }, "maxPagesPerVideo": { "title": "Maximum comment pages per video", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety guard against endpoint or cursor drift. Each page normally contains up to 20 comments, but TikTok may return fewer.", "default": 50 }, "maxReplyPagesPerComment": { "title": "Maximum reply pages per comment", "minimum": 1, "maximum": 500, "type": "integer", "description": "Safety guard for reply pagination. It applies only when replies are enabled.", "default": 10 }, "saveDiagnostics": { "title": "Save diagnostic rows", "type": "boolean", "description": "Save a compact non-chargeable diagnostic row when a video has no comments or a collection stops with an error.", "default": true } } }, "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 } } }, "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 } } } } } } } } } }