{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper: Followers, Bio & User Posts (No Login)", "description": "Scrape TikTok profiles and user posts from any profile URL or @handle: exact follower count, bio, verification and every public video with views, likes, comments and shares. No login, no cookies, no API key. Pay per result. Export to JSON, CSV or Excel.", "version": "0.2", "x-build-id": "rrqbPrGD5rMt4c3za" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stanvanrooy6~tiktok-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stanvanrooy6-tiktok-profile-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/stanvanrooy6~tiktok-profile-scraper/runs": { "post": { "operationId": "runs-sync-stanvanrooy6-tiktok-profile-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/stanvanrooy6~tiktok-profile-scraper/run-sync": { "post": { "operationId": "run-sync-stanvanrooy6-tiktok-profile-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", "type": "array", "description": "TikTok profile URLs (https://www.tiktok.com/@handle), @handles, sec_uid values (MS4wLjAB...) or numeric user IDs. Short links (vm.tiktok.com) are followed. One profile row plus its posts per entry.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Max posts per profile", "minimum": 0, "type": "integer", "description": "Cap on posts collected per profile, newest first (pinned posts come first). Set to 0 for the full publicly available feed.", "default": 100 }, "includeProfile": { "title": "Include profile rows", "type": "boolean", "description": "Write one profile row per handle (follower count, bio, verification, counts).", "default": true }, "includePosts": { "title": "Include post rows", "type": "boolean", "description": "Write one row per post (video stats, hashtags, music, cover and play URLs).", "default": true }, "region": { "title": "Region", "enum": [ "US", "GB", "DE", "FR", "CA", "AU", "NL", "ES", "IT", "BR", "MX", "JP", "ID", "PH" ], "type": "string", "description": "Country of the residential proxy and the app identity used for the post feed. Profiles are global; keep US unless you scrape creators whose content is region locked.", "default": "US" }, "startUrls": { "title": "Start URLs (alternative input)", "type": "array", "description": "Alternative Apify request list input. Merged with the Profiles field above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "postDateFrom": { "title": "Posts from", "type": "string", "description": "Optional inclusive ISO date or timestamp. Date-only bounds use UTC; the end date includes the whole day." }, "postDateTo": { "title": "Posts through", "type": "string", "description": "Optional inclusive ISO date or timestamp. Date-only bounds use UTC; the end date includes the whole day." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Keep posts with at least this many likes; applies before the output limit." }, "maxLikes": { "title": "Maximum likes", "minimum": 0, "type": "integer", "description": "Keep posts with at most this many likes. Leave blank for no upper bound." }, "excludePinnedPosts": { "title": "Exclude pinned posts", "type": "boolean", "description": "Skip posts marked as pinned by TikTok.", "default": false }, "postSort": { "title": "Order within scanned sample", "enum": [ "source", "newest", "oldest", "most_liked", "most_viewed" ], "type": "string", "description": "Source preserves TikTok feed order and streams matching rows. Other orders collect a bounded newest-first sample, sort its matches, then apply maxPostsPerProfile. This is not global oldest/popular sorting of an entire account.", "default": "source" }, "maxPostsToScan": { "title": "Source posts to scan per profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Applies when filters or sample sorting are enabled. maxPostsPerProfile counts matching output; the scan cap can leave fewer results. Ignored with default controls.", "default": 1000 } } }, "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 } } } } } } } } } }