{ "openapi": "3.0.1", "info": { "title": "TikTok Followers & Following Scraper — Audience Export", "description": "Export public TikTok Following lists without login, or Followers with your own TikTok session Cookie. Get profile URLs, bios, regions, and follower counts. Hidden or unavailable lists finish with a clear RUN_SUMMARY and no result-item charge. Never bypasses privacy. $0.50 per 1,000 results.", "version": "1.0", "x-build-id": "xa1cJ4TkncAF1m1JF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/funny_ground~tiktok-followers-following-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-funny_ground-tiktok-followers-following-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/funny_ground~tiktok-followers-following-scraper/runs": { "post": { "operationId": "runs-sync-funny_ground-tiktok-followers-following-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/funny_ground~tiktok-followers-following-scraper/run-sync": { "post": { "operationId": "run-sync-funny_ground-tiktok-followers-following-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": [ "profiles" ], "properties": { "profiles": { "title": "TikTok profiles", "minItems": 1, "maxItems": 100, "uniqueItems": true, "type": "array", "description": "TikTok usernames, @handles, or full profile URLs. The account and requested relationship list must be visible to the public or to your supplied session; a public profile can still hide its Following list. Duplicate profiles are removed before scraping.", "default": [], "items": { "type": "string" } }, "listType": { "title": "Relationship list", "enum": [ "following", "followers", "both" ], "type": "string", "description": "Following needs no login only when the target makes that list public. Followers needs sessionCookie because TikTok retired anonymous follower access. Both requires the Cookie and both lists to be accessible; it is atomic per profile, so if either list fails that profile writes no paid rows. Privacy settings are never bypassed.", "default": "following" }, "resultsPerList": { "title": "Results per profile and list", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum returned—and billed—profiles for each source profile and relationship list. Use 2 for a low-cost visibility test. Zero-result runs have no dataset-result charge, but Actor-start and compute charges can still apply. For Apify Free-plan users, a separate global limit of 50 dataset rows per run applies regardless of this field. Paid-plan users are not subject to that developer-set 50-row limit.", "default": 100 }, "sessionCookie": { "title": "Your TikTok Cookie (Followers / Both)", "type": "string", "description": "Required for Followers/Both. Paste the Cookie request header from your own logged-in tiktok.com browser; it must include sessionid (or sessionid_ss/sid_tt). It is sent only to tiktok.com and is never logged or stored in output. Cookies can expire and do not bypass target privacy settings." }, "requestTimeoutSecs": { "title": "HTTP request timeout", "minimum": 10, "maximum": 120, "type": "integer", "description": "Timeout per upstream HTTP request. The Actor never launches a browser or residential proxy.", "default": 30 }, "failOnNoResults": { "title": "Fail when no visible results are available", "type": "boolean", "description": "Off by default: hidden, private, or otherwise unavailable profiles finish successfully with 0 rows and an explanation in RUN_SUMMARY. Turn this on only if your automation needs a strict FAILED status for zero-result runs. Authentication, upstream, and code errors still fail either way.", "default": false } } }, "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 } } } } } } } } } }