{ "openapi": "3.0.1", "info": { "title": "TikTok Scraper: Videos, Hashtags, Profiles & Comments", "description": "Scrape TikTok without login: videos from hashtags, sounds, profiles and video links, with views, likes, comments, shares, saves, author follower counts, music and hashtags as flat columns. Add each video's comments, filter by date, or get only new videos on a schedule.", "version": "0.1", "x-build-id": "ix1iz0J7prtwn1SrP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/humble-echidna~tiktok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-humble-echidna-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/humble-echidna~tiktok-scraper/runs": { "post": { "operationId": "runs-sync-humble-echidna-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/humble-echidna~tiktok-scraper/run-sync": { "post": { "operationId": "run-sync-humble-echidna-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": { "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to get videos from, one per line: `cooking`, `#cooking` or a link like https://www.tiktok.com/tag/cooking. Returns the videos TikTok lists on the hashtag's page, in its order, up to Max videos per source each.", "items": { "type": "string" } }, "profiles": { "title": "Profiles", "type": "array", "description": "TikTok accounts, one per line: `nasa`, `@nasa` or https://www.tiktok.com/@nasa. Returns each account's latest videos as TikTok shows them to visitors who aren't logged in: about 10, newest first, a pinned video first if there is one. Private accounts return no videos.", "default": [ "nasa" ], "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Single videos or photo posts, one link per line: https://www.tiktok.com/@user/video/, a /photo/ link, or a short link (vm.tiktok.com/..., tiktok.com/t/...). One result per link, with fresh counts.", "items": { "type": "string" } }, "sounds": { "title": "Sounds", "type": "array", "description": "Sounds (music) to get the videos that use them, one per line: a link like https://www.tiktok.com/music/original-sound-7695060940479384334, or just the number at its end.", "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Max videos per source", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many of each hashtag's, sound's or profile's videos to look at, in TikTok's order, 1 to 1000 (default 10). Visitors who aren't logged in see about 120-160 per hashtag and the ~10 latest per profile. Only new and the date filter skip some of those. Video links give their one video.", "default": 10 }, "commentsPerVideo": { "title": "Comments per video", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Also return up to this many top-level comments for every video returned, 0 to 1000 (default 0: none). Each comment is one result at the lower comment price, in TikTok's order (top comments first). TikTok lists a few hundred per video to visitors who aren't logged in.", "default": 0 }, "repliesPerComment": { "title": "Replies per comment", "minimum": 0, "maximum": 100, "type": "integer", "description": "With comments on, also return up to this many replies to each comment that has any, 0 to 100 (default 0: none). Each reply is a comment result (with `replyTo` set to the comment it answers) and costs one more request per comment.", "default": 0 }, "newerThan": { "title": "Only videos newer than", "type": "string", "description": "Skip videos posted before this: a date like 2026-10-01, or an age like `7 days`, `24 hours`, `2 weeks`, `3 months`. Leave empty for no date filter. Skipped videos are never charged." }, "onlyNew": { "title": "Only new since the last run", "type": "boolean", "description": "For schedules: skip videos (from hashtags, sounds and profiles) and comments this input has returned before. Remembered per hashtag, sound, profile and video, in a store in your account, for 120 days. Video links always return their video; only their comments are filtered.", "default": false }, "profileRows": { "title": "Also return each profile", "type": "boolean", "description": "Add one result per profile with its follower, following, like and video counts, bio and bio link (charged like a video). Off by default: every video row already carries its author's counts.", "default": false }, "maxResults": { "title": "Max results per run", "minimum": 1, "type": "integer", "description": "Stop after this many results in total (videos, profiles and comments together), e.g. 100. Minimum 1; leave empty (the default) for no limit. The run also stops cleanly at the maximum cost per run you set in the run options, whichever comes first." } } }, "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 } } } } } } } } } }