{ "openapi": "3.0.1", "info": { "title": "TikTok Comments Scraper - Profiles & Date Range", "description": "Scrape comments from TikTok videos, or from the latest videos of any public profile with a date filter. Includes likes, reply counts and the creator-liked flag. No login.", "version": "1.0", "x-build-id": "hOi4mI7IkFBpUzaHp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/icoe-man~tiktok-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-icoe-man-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/icoe-man~tiktok-comments-scraper/runs": { "post": { "operationId": "runs-sync-icoe-man-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/icoe-man~tiktok-comments-scraper/run-sync": { "post": { "operationId": "run-sync-icoe-man-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", "properties": { "videoUrls": { "title": "TikTok video URLs", "type": "array", "description": "Links to public TikTok videos or photo posts (tiktok.com/@user/video/...), one per line. Short vm.tiktok.com links are not supported: open the video and copy its full address. Up to 1,000 per run.", "items": { "type": "string" } }, "profiles": { "title": "Profiles", "type": "array", "description": "Usernames or profile links, one per line (e.g. tiktok or https://www.tiktok.com/@tiktok). We collect comments from each profile's latest videos. Up to 200 per run; all 200 can be collected live in one run at default settings. Each profile has a small fee, plus the per-video fee for each of its videos that returned comments. Profile mode needs a paid Apify plan.", "items": { "type": "string" } }, "maxCommentsPerVideo": { "title": "Max comments per video", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many comments to collect per video. Up to 24 is fastest. Each comment is billed, plus a small fee per video.", "default": 24 }, "videosPerProfile": { "title": "Videos per profile", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many of each profile's latest videos to collect comments from. The small per-video fee is charged only for videos that return comments.", "default": 5 }, "onlyNewerThan": { "title": "Only videos newer than (profiles)", "type": "string", "description": "Profiles only: read comments from videos published after this date. Use a date like 2026-01-31 or a relative value like \"7 days\" or \"3 months\". Relative values are rounded down to the start of that UTC day (hours to the start of the hour), so runs on the same day use the same window. Leave empty for no date limit." }, "maxDataAgeHours": { "title": "Reuse data collected within (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "If we collected these comments within this many hours, you get them instantly at the same price. The form starts at 24; 6 is used when the field is left out. Higher values reuse older collected data (up to 720). Lower it for fresher data, or use 0 to always collect fresh data.", "default": 6 }, "cacheOnly": { "title": "Previously collected data only (instant)", "type": "boolean", "description": "Return only comments we already collected, without waiting for live collection. Works for video URLs; profiles almost always need live collection. Useful for AI agents with short timeouts.", "default": false } } }, "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 } } } } } } } } } }