{ "openapi": "3.0.1", "info": { "title": "TikTok Stories Scraper: Active Stories & Video Links, No Login", "description": "Get the stories any public TikTok account has up right now: video and photo links, best-quality MP4, post and expiry time, views, likes, sound and caption. Optionally save the files to Apify so they outlive the 24 hours, or return only stories you have not seen yet. No login. Many accounts per run.", "version": "0.1", "x-build-id": "9iYs1jz7T5PiNl87S" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~tiktok-stories-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-tiktok-stories-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-stories-scraper/runs": { "post": { "operationId": "runs-sync-neverempty-tiktok-stories-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-stories-scraper/run-sync": { "post": { "operationId": "run-sync-neverempty-tiktok-stories-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 whose active stories you want: a username (jamescharles or @jamescharles), a profile URL (https://www.tiktok.com/@jamescharles) or a numeric user ID (15 to 21 digits). One per line (commas and spaces also separate entries), up to 200 per run. Accounts with no story up right now come back as a free row. Short links (vm.tiktok.com) are not followed: open one in a browser and paste the profile URL.", "items": { "type": "string" } }, "maxStoriesPerProfile": { "title": "Maximum stories per account", "minimum": 1, "maximum": 500, "type": "integer", "description": "At most this many charged story rows per account. If the account has more stories up, a free row says how many were left out.", "default": 100 }, "order": { "title": "Order", "enum": [ "oldest-first", "newest-first" ], "type": "string", "description": "oldest-first is the order TikTok plays the stories in. newest-first puts the latest story first, which together with a low maximum gives just the latest ones.", "default": "oldest-first" }, "onlyNewStories": { "title": "Only stories not returned before", "type": "boolean", "description": "For scheduled runs: return only stories that an earlier run with the same monitor name did not return, so each story is paid for once. The first run returns every active story. Accounts with nothing new get a free no-new-stories row.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[A-Za-z0-9-]{0,40}$", "type": "string", "description": "Used only with 'Only stories not returned before'. Runs with the same name share one memory of returned stories; use different names for separate schedules. Letters, digits and hyphens, up to 40.", "default": "default" }, "saveMedia": { "title": "Save videos and photos to Apify", "type": "boolean", "description": "Download each story's best-quality MP4 (or all of its photos) into this run's key-value store and put links that open without any header in savedMediaUrls. TikTok's own links expire within hours and video links need a Referer header. Rows with saved media are charged at the higher media price.", "default": false }, "useProxy": { "title": "Use a proxy if TikTok refuses", "type": "boolean", "description": "Every page is requested directly first. Only a rate limit (HTTP 429 or 503), an empty response or no response is retried through a US proxy. A verification page is never retried: the run stops there. Off = no proxy is used or 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 } } } } } } } } } }