{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Videos Scraper – No Login", "description": "Scrape public videos from one or more TikTok profiles. Export video URLs, captions, dates, authors, music and engagement stats to one Dataset row per video. No TikTok account, login or API key is required.", "version": "0.1", "x-build-id": "CnDPKCdj7e9eC7UL2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datascraperes~tiktok-profile-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datascraperes-tiktok-profile-videos-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-profile-videos-scraper/runs": { "post": { "operationId": "runs-sync-datascraperes-tiktok-profile-videos-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-profile-videos-scraper/run-sync": { "post": { "operationId": "run-sync-datascraperes-tiktok-profile-videos-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": [ "profiles" ], "properties": { "profiles": { "title": "TikTok usernames or profile URLs", "minItems": 1, "maxItems": 1000, "type": "array", "description": "Enter @username, username, or a public TikTok profile URL such as https://www.tiktok.com/@username. Video, hashtag, and sound URLs are not accepted.", "items": { "type": "string", "minLength": 1, "pattern": "^(@?[A-Za-z0-9._-]{1,64}|https?://(?:www\\.)?tiktok\\.com/@[A-Za-z0-9._-]{1,64}/?(?:[?#][^\\s]*)?)$" } }, "startIndex": { "title": "Batch start index", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Zero-based index in the deduplicated profile list. Use nextStartIndex from SUMMARY to resume a large batch.", "default": 0 }, "maxProfilesPerRun": { "title": "Profiles per run", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum profiles processed by this run. Increase gradually for large jobs; results stream to the Dataset.", "default": 100 }, "maxVideosPerProfile": { "title": "Maximum videos per profile", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Stop a profile after this many unique videos. Set 0 for all public items exposed by TikTok.", "default": 5 }, "maxTotalVideos": { "title": "Maximum videos in this run", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Hard run-wide video limit. Set 0 for no explicit result limit; PPE and Actor timeout guards still apply.", "default": 5 }, "maxPagesPerProfile": { "title": "Maximum pages per profile", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety guard against parser or cursor drift. A normal page contains at most 15 videos.", "default": 1000 }, "includeCoverUrls": { "title": "Include cover URLs", "type": "boolean", "description": "Include public cover URL fields when TikTok returns them. CDN URLs may expire.", "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 } } } } } } } } } }