{
"openapi": "3.0.1",
"info": {
"title": "TikTok Followers Scraper 🎵 Follower & Following Lists",
"description": "Export any TikTok creator's followers and the accounts they follow. Handle, name, bio, verification and audience size for every account, with duplicates removed. Paste handles. Export to JSON, CSV or Excel. No login, no API key.",
"version": "0.1",
"x-build-id": "RbvUVIbQ9alBxRcpH"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/gatherworks~tiktok-followers-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-gatherworks-tiktok-followers-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/gatherworks~tiktok-followers-scraper/runs": {
"post": {
"operationId": "runs-sync-gatherworks-tiktok-followers-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/gatherworks~tiktok-followers-scraper/run-sync": {
"post": {
"operationId": "run-sync-gatherworks-tiktok-followers-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": {
"usernames": {
"title": "👤 Usernames or profile URLs",
"type": "array",
"description": "Whose audience to export. tiktok, @tiktok and a full profile URL all work.",
"items": {
"type": "string"
}
},
"includeFollowers": {
"title": "👥 Their followers",
"type": "boolean",
"description": "Collect the accounts that follow this creator. On by default.",
"default": true
},
"includeFollowing": {
"title": "🔄 The accounts they follow",
"type": "boolean",
"description": "Collect the accounts this creator follows — often a much shorter and more revealing list.",
"default": false
},
"includeSeedCreator": {
"title": "👤 Also return the creator you searched",
"type": "boolean",
"description": "Adds one row per creator whose list you collected — their own follower count, bio and verification. Off by default: the follower and following rows are what most runs are for. Billed as an add-on when switched on.",
"default": false
},
"maxAccountsPerCreator": {
"title": "🔢 Maximum accounts per creator",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Caps how many accounts are returned for each creator and each list. Cost scales linearly with this number.",
"default": 200
},
"minFollowers": {
"title": "🔢 Minimum followers",
"minimum": 0,
"type": "integer",
"description": "Keep only accounts with at least this many followers — useful for finding the notable names in a large audience."
},
"verifiedOnly": {
"title": "✅ Verified accounts only",
"type": "boolean",
"description": "Keep only accounts carrying a verified badge.",
"default": false
},
"maxScanned": {
"title": "🚧 Maximum accounts skipped by your filters",
"minimum": 100,
"maximum": 40000,
"type": "integer",
"description": "Only applies when a verified-only or minimum-follower filter is set. Caps how many accounts those filters may reject before the Actor stops and returns what it found, so a selective filter cannot walk an entire follower list. Accounts it keeps do not count towards this, and the effective limit is never more than eight times the accounts-per-creator limit.",
"default": 1600
}
}
},
"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
}
}
}
}
}
}
}
}
}
}