{ "openapi": "3.0.1", "info": { "title": "Tiktok Followers Api Scraper", "description": "Extract followers data from TikTok profiles using this API scraper. Collect usernames, profile URLs, display names, follower counts, and account details. Useful for influencer research, audience analysis, competitor monitoring, and tracking growth of TikTok accounts.", "version": "0.1", "x-build-id": "vzQ4qzgIaMQz3Rpoo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~tiktok-followers-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-tiktok-followers-api-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/api-empire~tiktok-followers-api-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-tiktok-followers-api-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/api-empire~tiktok-followers-api-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-tiktok-followers-api-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", "required": [ "sid_tt" ], "properties": { "username": { "title": "๐ŸŽฏ TikTok username", "type": "string", "description": "Type the **handle only** โ€” no **@**, no **https://** โœ‚๏ธ\n\nโœ… **Good:** `nike` ยท `khaby.lame` ยท `mrbeast`\n\nโŒ **Skip:** `@nike` or full links (use the **URL** field below for those ๐Ÿ”—).\n\n๐Ÿง  Leave blank if you're only using a profile URL โ€” either path works!", "default": "mrbeast" }, "sid_tt": { "title": "๐Ÿ”‘ TikTok session cookie (sid_tt)", "type": "string", "description": "**โญ Required** โ€” TikTok won't show follower lists without a **real logged-in session**.\n\n๐Ÿชœ **How to copy sid_tt:**\n1๏ธโƒฃ Open **tiktok.com** in Chrome/Edge ยท **log in** ๐Ÿ‘‹\n2๏ธโƒฃ Press **F12** โ†’ **Application** (or **Storage**)\n3๏ธโƒฃ **Cookies** โ†’ **tiktok.com**\n4๏ธโƒฃ Find **sid_tt** โ†’ **copy the value** ๐Ÿ“‹\n\nโš ๏ธ **Heads-up:** Treat this like a password โ€” don't share it publicly. Rotate if you pasted it somewhere by mistake.", "default": "" }, "userUrl": { "title": "๐ŸŒ Profile URL (optional)", "type": "string", "description": "Paste the **full TikTok profile URL** and we'll **auto-extract** the username for you ๐Ÿช„\n\nโœ… **Example:** `https://www.tiktok.com/@nickiminai`\n\n๐Ÿค **Username + URL:** You can fill **one or both** โ€” handy if you batch different sources later.\n\n๐Ÿ’ค **Username alone?** You can leave this empty.", "default": "" }, "maxFollowersPerProfile": { "title": "๐Ÿ”ข Max followers per profile", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Set the **ceiling** for how many followers we try to grab **per profile** (allowed range: **1โ€“10000**).\n\n๐ŸŒ€ We **scroll the followers UI** until we hit your number **or** TikTok stops loading more.\n\nโฑ๏ธ **More followers = longer runs** โ€” start modest, then go big once you're happy with the output!\n\n๐ŸŽฏ This Actor focuses on **followers only** (not following lists, not videos).", "default": 10 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy configuration", "type": "object", "description": "**๐ŸŽ›๏ธ Fine-tune connectivity.**\n\n๐Ÿ **Default:** **No proxy** to start โ€” simplest & often enough.\n\n๐Ÿ”„ **Auto-fallback:** If blocked, we retry with **datacenter** then **residential** Apify Proxy (with retries) ๐Ÿ’ช\n\n๐Ÿš€ **Want proxy immediately?** Toggle **Apify Proxy** on here so every hop is routed from **second zero**.\n\n๐ŸŒ Great for stricter regions or heavier scraping sessions." } } }, "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 } } } } } } } } } }