{ "openapi": "3.0.1", "info": { "title": "TikTok Followers & Following Scraper — Audience Profiles", "description": "Export TikTok Following lists only when targets make them public; a public profile may still hide its list. Followers/Both require your own valid TikTok session Cookie. Never bypasses privacy. Hidden or zero-result profiles have no dataset-result charge; Both mode is atomic.", "version": "1.0", "x-build-id": "An4HHcYWOCrCMPkWU" }, "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.", "default": 100 }, "sessionCookie": { "title": "Your TikTok Cookie (Followers only)", "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 } } }, "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 } } } } } } } } } }