{ "openapi": "3.0.1", "info": { "title": "TikTok Scraper", "description": "Scrape public TikTok accounts (bio, followers, likes), each account's newest videos, single video links with full stats, and a hashtag's top videos. Up to 10 videos per account or hashtag. No login. No comments, no search, no follower lists.", "version": "0.1", "x-build-id": "dGaVM3nJKTOV3vywm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akatra~tiktok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akatra-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/akatra~tiktok-scraper/runs": { "post": { "operationId": "runs-sync-akatra-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/akatra~tiktok-scraper/run-sync": { "post": { "operationId": "run-sync-akatra-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": "TikTok usernames or profile links, one per line, for example 'nike', '@nike' or https://www.tiktok.com/@nike. Each profile gives one account record plus its newest videos (up to 10).", "items": { "type": "string" } }, "videoUrls": { "title": "Video links", "type": "array", "description": "Links of single videos, one per line, for example https://www.tiktok.com/@nike/video/7691822999523101966. Each link gives the full video record. Short vm.tiktok.com links are not supported.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags without or with '#', one per line, for example 'running'. TikTok shows about 10 top videos per hashtag to logged-out visitors, so that is the most you get per hashtag.", "items": { "type": "string" } }, "maxVideosPerProfile": { "title": "Max videos per profile", "minimum": 0, "maximum": 100, "type": "integer", "description": "How many of the newest videos to save for each profile. TikTok's public pages show logged-out visitors only the 10 newest videos of an account, so 10 is the most you can get; a higher number is treated as 10 and the run status says so. Pinned videos are included only when they are among your newest N. Use 0 to save only the account records.", "default": 10 }, "maxVideosPerHashtag": { "title": "Max videos per hashtag", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many top videos to save for each hashtag. TikTok's public pages show logged-out visitors at most about 10, so 10 is the maximum.", "default": 10 }, "onlyNew": { "title": "Only new videos", "type": "boolean", "description": "Save only videos that an earlier run of this Actor has not already delivered, for scheduled monitoring. The first run saves everything it finds. Videos that your filters leave out are not remembered, so they can still come back later. Account records are saved on every run. Off by default.", "default": false }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Save only videos with at least this many views. Applied by this Actor after the video is loaded, not by TikTok." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Save only videos with at least this many likes. Applied by this Actor after the video is loaded, not by TikTok." }, "minComments": { "title": "Minimum comments", "minimum": 0, "type": "integer", "description": "Save only videos with at least this many comments (the number, not the comments themselves). Applied by this Actor after the video is loaded, not by TikTok." }, "dateFrom": { "title": "Posted from", "type": "string", "description": "Save only videos posted on or after this date (UTC), for example 2026-10-01. Applied by this Actor after the video is loaded, not by TikTok." }, "dateTo": { "title": "Posted until", "type": "string", "description": "Save only videos posted on or before this date (UTC), for example 2026-10-31. Applied by this Actor after the video is loaded, not by TikTok." }, "language": { "title": "Video language", "type": "string", "description": "Language code such as 'en' or 'tr'. Videos whose language TikTok states and that differs are left out; videos with no language information are kept (hashtag and video pages from the fallback source carry none). Applied by this Actor, not by TikTok." }, "hashtag": { "title": "Must contain hashtag", "type": "string", "description": "Save only videos whose description contains this hashtag, with or without '#', for example 'running'. Applied by this Actor, not by TikTok." } } }, "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 } } } } } } } } } }