{ "openapi": "3.0.1", "info": { "title": "TikTok Scraper - Profiles, Videos, Comments, No Login", "description": "TikTok profile videos with exact dates, views, likes, shares, saves, sound and author bio, plus optional comments and transcripts, in one run. Filter by date range, read photo posts and share links. No login, no cookies, no browser. From $1.50 per 1,000 videos.", "version": "1.0", "x-build-id": "QjBpiKwD8291VmJBd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~tiktok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-tiktok-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/benthepythondev~tiktok-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-tiktok-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/benthepythondev~tiktok-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-tiktok-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": { "profiles": { "title": "Profiles", "type": "array", "description": "Usernames, @handles or profile links (https://www.tiktok.com/@nasa). Each profile's videos and photo posts are read from the newest back, up to the maximum below; every row carries the account's bio, bio link and exact follower count. Hashtags and search terms cannot be read here.", "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Links of single videos or photo posts (https://www.tiktok.com/@nasa/video/7692161454694206733), share links (vm.tiktok.com/…, tiktok.com/t/…) or bare video ids. Every link gives one row with the same columns as a profile's videos. Links of hashtag, search and music pages cannot be read here.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum videos per profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Videos to save for each profile, newest first. Set it high to export a profile's whole history. It does not apply to video links: every link is read.", "default": 20 }, "postedAfter": { "title": "Posted on or after", "type": "string", "description": "Only a profile's videos from this UTC day on (YYYY-MM-DD), or from a period back from now (7 days, 2 months). Reading stops at the first older videos, so a scheduled run reads and charges only what is new. No extra charge. Not applied to video links." }, "postedBefore": { "title": "Posted on or before", "type": "string", "description": "Upper end of a date range (YYYY-MM-DD) for a profile's videos. The profile's list is asked from this day back, so newer videos are neither read nor charged. Not applied to video links." }, "includeTranscript": { "title": "Add the spoken text", "type": "boolean", "description": "Puts the text of TikTok's own subtitle track into the column transcript, for every video that has one. A video without a track (music, no speech, or not captioned by TikTok) keeps an empty column. No extra charge. This is TikTok's text, not speech recognition by the Actor.", "default": false }, "commentsPerVideo": { "title": "Comments per video", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Comments to save for each video, as rows of their own after the video rows: text, author, likes, reply count, time. 0 reads no comments. The number counts comments and replies together. Comment rows have their own, lower price.", "default": 0 }, "maxRepliesPerComment": { "title": "Replies per comment", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Replies to read under each comment that has some; they follow their comment and count towards the comments per video. 0 keeps to top-level comments.", "default": 0 } } }, "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 } } } } } } } } } }