{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper: Followers, Posts, Bio Email, $2.5/1K", "description": "TikTok public profiles and latest posts: followers, likes, video count, bio, bio link, emails and links in bio, verified, business category, plus each recent video's plays, likes, comments, shares, saves, hashtags, music and engagement rate. Video URLs too. No login.", "version": "0.1", "x-build-id": "IteFPxfJxDjcVMB5D" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/transparent_meteorite~tiktok-public-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-transparent_meteorite-tiktok-public-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/transparent_meteorite~tiktok-public-profile-scraper/runs": { "post": { "operationId": "runs-sync-transparent_meteorite-tiktok-public-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/transparent_meteorite~tiktok-public-profile-scraper/run-sync": { "post": { "operationId": "run-sync-transparent_meteorite-tiktok-public-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 (usernames or profile URLs)", "type": "array", "description": "TikTok usernames (with or without @) or profile URLs like https://www.tiktok.com/@natgeo. Video URLs pasted here work too.", "default": [ "natgeo" ], "items": { "type": "string" } }, "postURLs": { "title": "Video URLs", "type": "array", "description": "Individual TikTok video or photo post URLs (vm.tiktok.com short links too). Each returns one post row with full stats and author data.", "items": { "type": "string" } }, "resultsType": { "title": "Output", "enum": [ "posts", "profiles", "both" ], "type": "string", "description": "What each dataset row is. Profile rows add average and median views, engagement rate and posting frequency of the latest posts.", "default": "posts" }, "resultsPerPage": { "title": "Latest posts per profile", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many of the newest posts to read per profile. TikTok's public (logged-out) view shows about the latest 10-13 posts, so that is the practical ceiling. 0 = profile data only.", "default": 10 }, "includeVideoDetails": { "title": "Full post stats (likes, comments, shares, saves, date, music, hashtags)", "type": "boolean", "description": "Opens each post's public page for the complete stats. Off = faster, only caption, views and cover.", "default": true }, "oldestPostDate": { "title": "Only posts newer than", "type": "string", "description": "A date (2026-10-01) or a period (7 days, 2 weeks, 3 months). Older posts are skipped and not charged." }, "newestPostDate": { "title": "Posts up to (newest date)", "type": "string", "description": "Optional. Drops posts published after this date (\"2026-09-30\", or relative like \"7 days\"). Combine with the oldest date for an exact from-to window. Dropped posts are not charged." }, "minPlayCount": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Skip posts with fewer views (not charged)." }, "leastDiggs": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Optional. Only posts with at least this many likes. Works together with the date and play filters." }, "mostDiggs": { "title": "Maximum likes", "minimum": 0, "type": "integer", "description": "Optional. Only posts with at most this many likes (find small, rising posts)." }, "profileSorting": { "title": "Sort posts", "enum": [ "latest", "popular", "oldest" ], "type": "string", "description": "Order of the post rows for each profile.", "default": "latest" }, "excludePinnedPosts": { "title": "Skip pinned posts", "type": "boolean", "description": "Pinned posts are usually old. Needs full post stats on.", "default": false }, "maxItems": { "title": "Max rows", "minimum": 1, "type": "integer", "description": "Hard cap on rows (and cost) for the whole run.", "default": 1000 }, "monitorMode": { "title": "Monitor mode: only new posts", "type": "boolean", "description": "Remembers posts already delivered (named key-value store) and returns only new ones next run; profile rows get follower change since the last run. Already-seen posts are not charged. Schedule it daily.", "default": false }, "monitorStoreName": { "title": "Monitor store name", "type": "string", "description": "Use a different name per watch list.", "default": "tiktok-profile-monitor" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (default) works. The actor switches to residential IPs by itself after repeated blocks.", "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 }, "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 } } } } } } } } } }