{ "openapi": "3.0.1", "info": { "title": "TikTok Latest Posts Monitor", "description": "Check any public TikTok profile for its latest posts: caption, hashtags, views, likes, comments, shares, video files, photo carousels and the full account record. No login, no cookies, no API key. Built for polling many accounts often rather than deep history: up to 13 posts per profile. Unofficial.", "version": "0.1", "x-build-id": "hqrUs1JnkOZYwQT0s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simple.actors~tiktok-profile-posts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simple.actors-tiktok-profile-posts", "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/simple.actors~tiktok-profile-posts/runs": { "post": { "operationId": "runs-sync-simple.actors-tiktok-profile-posts", "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/simple.actors~tiktok-profile-posts/run-sync": { "post": { "operationId": "run-sync-simple.actors-tiktok-profile-posts", "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": { "startUrls": { "title": "Profile URLs", "type": "array", "description": "Public TikTok profile URLs, one per account, e.g. https://www.tiktok.com/@nasa. A link to one of the account's videos works too — it is read as the account. This field only accepts real URLs; to give bare handles like \"nasa\", use the Handles field below. You can use both together.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "handles": { "title": "Handles", "uniqueItems": true, "type": "array", "description": "TikTok handles without the URL, e.g. nasa or @nasa. Use this instead of Profile URLs when you have handles rather than links; the two lists are read together.", "items": { "type": "string" } }, "maxPosts": { "title": "Posts per profile", "minimum": 1, "maximum": 13, "type": "integer", "description": "How many of the latest posts to return per account. TikTok renders one batch to a logged-out reader and offers no way to ask for more, so this is capped at 13 — most accounts return 10 to 12. Lower it only if you want fewer rows; it does not make the run cheaper.", "default": 13 }, "onlyPostsNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Keep only posts published after this moment. Accepts an ISO date (2026-08-01) or a window (\"3 days\", \"12 hours\"). If the account's latest batch does not reach back that far, the run fails for that account rather than returning a partial list that would read as complete — shorten the window or poll more often." }, "includePostDetails": { "title": "Read each post's full detail", "type": "boolean", "description": "On by default. Reads one extra request per post to get its like, comment and share counts, TikTok's own posted time, the music, the hashtags and mentions, and the images of a photo post. Turn it off for a fast, cheap listing: you keep the caption, view count, cover and video file, but engagement counts become null and the posted time is derived from the post id (accurate to about a minute).", "default": true }, "includeProfileDetails": { "title": "Read exact follower counts", "type": "boolean", "description": "On by default. Reads the profile page for the account's exact follower and like counts plus its fuller record. With this off — or if TikTok challenges the page — the counts come from the embed and are rounded to two significant figures (1,200,000 rather than 1,161,914), which will not move as the account grows. Every item says which it got in \"author.followersAreExact\".", "default": true }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify Proxy settings. The default datacenter group is enough — TikTok's embed served every datacenter request tested without a challenge, and showed no rate limiting. Switch to residential only if accounts start coming back as read failures.", "default": { "useApifyProxy": 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 } } } } } } } } } }