{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper: Exact Stats, No Login", "description": "Scrape TikTok profiles by handle or URL with no login: exact follower, like and video counts, bio, bio link with risk score, verified, commerce category, account age, LIVE status and up to 10 latest posts with play counts. Follower deltas between runs. JSON, CSV, API, schedules. Pay per profile.", "version": "0.1", "x-build-id": "jndjP2JRnPU4Mgyys" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~tiktok-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~tiktok-profile-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~tiktok-profile-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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": "TikTok handles or profile URLs", "type": "array", "description": "One value per line: nike, @nike, https://www.tiktok.com/@nike or tiktok.com/embed/@nike. A handle has 2 to 24 letters, digits, dots or underscores. Every value gets exactly one row, in the order given; duplicates, post URLs and anything that is not a handle get a free status row.", "items": { "type": "string" } }, "maxProfiles": { "title": "Maximum profiles", "minimum": 0, "type": "integer", "description": "Stop after this many profiles are delivered. Values after the cap are not fetched and get a free status row with status skipped. 0 means no cap." }, "includeLatestPosts": { "title": "Include the latest posts", "type": "boolean", "description": "Free. Adds latestPosts: up to the 10 latest posts from the creator's embed page (plus up to 3 pinned posts, flagged isPinned) with caption, play count as TikTok reports it (4 significant digits), cover and video URLs, and the average, median, highest and lowest plays over them. Turn off for the card only (one request per profile)." }, "fetchPostDetails": { "title": "Read each post's details", "type": "boolean", "description": "Free but slower. Opens the page of every latest post for its publish time, exact like, comment, share and save counts, hashtags, music and caption file links; this fills postsPerWeek, daysSinceLastPost and engagementRate. Measured on Apify: 10 to 13 extra pages per profile make a run take about 1.6 seconds more per profile (54 profiles in 104 seconds instead of 15, all 609 post pages answered)." }, "memoryName": { "title": "Memory name", "type": "string", "description": "Optional. A name for a snapshot memory kept between runs. With it every row carries followerDelta, heartDelta, videoDelta, newPostIds and previousRunAt against the previous run under the same name. Profiles are delivered and charged on every run; if the memory cannot be opened the change fields are null and a status row says so." }, "resetMemory": { "title": "Reset the memory", "type": "boolean", "description": "Forget every snapshot stored under the memory name before this run starts; every profile then counts as first seen." }, "tryDirectFirst": { "title": "Try the platform IP first", "type": "boolean", "description": "When on, the first request for each page goes straight from the Apify platform and every retry goes through the proxy below on a fresh session. Measured on Apify: the platform IP answered the profile and embed pages on the first try and 2 to 3 times faster. Turn off to send every request through the proxy." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The proxy used for retries (and for every request when the option above is off). Apify datacenter proxy by default; no residential proxy is needed." }, "maxConcurrency": { "title": "Parallel profiles", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many profiles are fetched at the same time, 1 to 8. Rows are still written in your order." } } }, "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 } } } } } } } } } }