{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper - Videos & New Post Monitor", "description": "Export every video a TikTok account posted: caption, post time, views, likes, comments, shares, saves, duration, sound, hashtags, pinned and photo posts, with a date range. Monitoring mode returns only videos posted since the last run. Unofficial. Public data only.", "version": "0.1", "x-build-id": "90DlDORJqz1fd6ObP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~tiktok-profile-videos-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-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/neverempty~tiktok-profile-videos-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-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/neverempty~tiktok-profile-videos-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-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", "properties": { "profiles": { "title": "TikTok accounts", "type": "array", "description": "Accounts to list the videos of: a username (nasa or @nasa), a profile URL (https://www.tiktok.com/@nasa, with or without the scheme; a video URL of the account works too) or a secUid (MS4wLjABAAAA...). One per line (commas and spaces also separate entries). Short links (vm.tiktok.com) are not followed: open one in a browser and paste the profile URL. A repeated account is read and charged once and the repeat gets a free 'duplicate' row. If you leave this field out with monitoring off, one example account is read; with monitoring on it is required. An empty list is rejected.", "items": { "type": "string" } }, "maxVideosPerProfile": { "title": "Maximum videos per account", "minimum": 1, "maximum": 10000, "type": "integer", "description": "With monitoring off, reading an account stops once this many charged video rows have been returned for it, newest first, and a free row says so. In monitoring mode it limits only the first check of an account; later checks return every new video found, as far as the run's maximum total charge allows.", "default": 100 }, "postedAfter": { "title": "Only videos posted on or after", "pattern": "^(\\d{4}-\\d{2}-\\d{2}([T ][\\d:.]+(Z|[+-]\\d{2}:?\\d{2})?)?|\\d{1,5}\\s*(d|day|days))$", "type": "string", "description": "Optional. A date (2026-09-01, read as 00:00 UTC), a time (2026-09-01T12:00:00Z) or a number of days back (30 days). Older videos are not returned or charged, and reading an account stops once it reaches videos 3 days older than this (TikTok's list is not strictly in time order)." }, "postedBefore": { "title": "Only videos posted before", "pattern": "^(\\d{4}-\\d{2}-\\d{2}([T ][\\d:.]+(Z|[+-]\\d{2}:?\\d{2})?)?|\\d{1,5}\\s*(d|day|days))$", "type": "string", "description": "Optional. Same formats as postedAfter. Reading starts at this time instead of at the newest video, so older periods can be exported without paying for newer videos. Not available in monitoring mode." }, "monitoringMode": { "title": "Monitoring mode: return only videos posted since the last run", "type": "boolean", "description": "Off = every run returns the account's videos, charged per row. On = the first run of an account returns up to maxVideosPerProfile videos and remembers the time of that check; later runs return only videos posted after the previous check that were not returned before. **In monitoring mode every account checked costs $0.30 per 1,000 checks, whether or not it has new videos**, plus the row price for the videos returned. Example: 100 accounts checked every hour = 72,000 checks a month = $21.60. The Actor checks only as many accounts as the run's maximum total charge can pay for with a check and a video row each. Remembered per account; do not put the same account in two schedules that can run at the same time.", "default": false }, "resetMonitoringState": { "title": "Forget what was remembered and start over", "type": "boolean", "description": "Clears everything remembered for every account, so the next monitoring run treats each account as a first check again. This affects all your monitoring runs, because the memory is stored per account rather than per list. Turn it off again after one run: left on in a schedule, every run is a first check and charges for up to maxVideosPerProfile videos per account.", "default": false }, "useProxy": { "title": "Use a proxy if TikTok answers with a rate limit", "type": "boolean", "description": "Every page is requested directly first. Only if TikTok answers a page with a rate limit (HTTP 429 or 503), an empty response or no response is that page retried through a proxy session located in the United States; the next page is requested directly again. A verification page is never retried: the run stops there. With it off, a rate limit is retried directly and then returned as a free 'blocked' row, and no proxy is paid for.", "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 }, "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 } } } } } } } } } }