{ "openapi": "3.0.1", "info": { "title": "TikTok Latest Post Scraper & Activity Tracker", "description": "Find the latest public TikTok post date, video link, caption, and profile stats from usernames or URLs. Check creator activity in bulk, flag inactive accounts, and export JSON, CSV, or Excel for influencer research and competitor monitoring.", "version": "0.4", "x-build-id": "h99TcQxutRohZq4FV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/newbs~Latest-Post-Time-TikTok/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-newbs-Latest-Post-Time-TikTok", "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/newbs~Latest-Post-Time-TikTok/runs": { "post": { "operationId": "runs-sync-newbs-Latest-Post-Time-TikTok", "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/newbs~Latest-Post-Time-TikTok/run-sync": { "post": { "operationId": "run-sync-newbs-Latest-Post-Time-TikTok", "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": { "channel": { "title": "TikTok profiles", "maxItems": 1000, "type": "array", "description": "Up to 1,000 TikTok usernames, @handles, or tiktok.com/@handle URLs. Case is normalized and duplicate fetches are reused. One row per input, including duplicates. Empty input uses dior, adidas, and neymarjr.", "items": { "type": "string" } }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional. The fast embed path works without a proxy. If an embed is blocked, retry it once through this proxy before the managed fallback; also used for final direct requests." }, "useManagedFallback": { "title": "Use managed latest-post fallback", "type": "boolean", "description": "On Apify, send only unresolved unique profiles to a managed TikTok scraper. This child Actor can add a separate charge under its current pricing. Disable to prevent child runs.", "default": true }, "managedFallbackTimeoutSecs": { "title": "Managed fallback timeout", "minimum": 30, "maximum": 600, "type": "integer", "description": "Maximum runtime for the managed TikTok Profile Scraper child run.", "default": 60 }, "useBrowserFallback": { "title": "Legacy browser fallback (deprecated)", "type": "boolean", "description": "Accepted for backward compatibility but ignored. The challenged browser path was removed because it added a large startup and timeout penalty without reliable latest-post results.", "default": false }, "maxConcurrency": { "title": "Profile concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum profiles processed concurrently by the official embed and direct HTTP paths.", "default": 10 }, "httpTimeoutSecs": { "title": "Fast HTTP timeout", "minimum": 3, "maximum": 60, "type": "integer", "description": "Maximum seconds for each official embed or direct fallback request.", "default": 6 }, "activityWindowDays": { "title": "Activity window (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Set isActiveWithinWindow to true when the latest exposed post is within this many days. Missing timestamps produce null, not false.", "default": 30 }, "maxRequestRetries": { "title": "Direct request retries", "minimum": 0, "maximum": 3, "type": "integer", "description": "Extra attempts for transient HTTP errors or network failures on the final direct request. Does not retry private, missing, or empty profiles.", "default": 0 } } }, "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 } } } } } } } } } }