{ "openapi": "3.0.1", "info": { "title": "TikTok Post Scraper", "description": "Scrape TikTok posts from any profile or video URLs: captions, plays, likes, comments, shares, saves, duration, music, hashtags, mentions and author follower stats. Filter by date. No login or API key needed. Export to JSON, CSV or Excel. Pay only for posts you get.", "version": "0.0", "x-build-id": "0X9eiUIx17CMEvx1p" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/arisma_tech~tiktok-post-apify-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-arisma_tech-tiktok-post-apify-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/arisma_tech~tiktok-post-apify-scraper/runs": { "post": { "operationId": "runs-sync-arisma_tech-tiktok-post-apify-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/arisma_tech~tiktok-post-apify-scraper/run-sync": { "post": { "operationId": "run-sync-arisma_tech-tiktok-post-apify-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": "Profiles", "maxItems": 500, "type": "array", "description": "TikTok profile URLs or usernames, e.g. https://www.tiktok.com/@hyundaiuk, @hyundaiuk or hyundaiuk. The latest posts of each profile are scraped.", "items": { "type": "string" } }, "postURLs": { "title": "Post URLs", "maxItems": 1000, "type": "array", "description": "Individual TikTok post links, e.g. https://www.tiktok.com/@hyundaiuk/video/7691236769001524513. Short links (vm.tiktok.com, vt.tiktok.com, tiktok.com/t/...) also work. Profile filters below don't apply to these.", "items": { "type": "string" } }, "resultsPerPage": { "title": "Posts per profile", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of latest posts to return for each profile.", "default": 100 }, "oldestPostDate": { "title": "Oldest post date", "type": "string", "description": "Only return profile posts published on or after this date. Absolute (2026-09-18) or relative (7 days, 2 weeks, 3 months). Pinned posts never stop the scrape." }, "excludePinnedPosts": { "title": "Exclude pinned posts", "type": "boolean", "description": "Skip posts pinned to the top of a profile.", "default": false }, "enrichAuthorMeta": { "title": "Full author data for post URLs", "type": "boolean", "description": "Post pages don't include the author's bio link or friend count. When on, the author's profile is fetched once per author (plain HTTP, no browser) so post URL results have the same authorMeta as profile results.", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to access TikTok. If no proxy is set (or Apify Proxy is turned off without custom proxy URLs), Apify RESIDENTIAL proxy is used automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }