{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper - Videos, Followers & Hashtag Views", "description": "Scrape public TikTok profiles by handle or link: follower, like and video counts, then every video with views, likes, comments, shares, caption, hashtags, sound and posting date. Also reads single videos by link, related videos and hashtag view totals. No login.", "version": "0.2", "x-build-id": "T0f8wZPMQSWh0hAWL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~tiktok-profile/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-tiktok-profile", "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/s-r~tiktok-profile/runs": { "post": { "operationId": "runs-sync-s-r-tiktok-profile", "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/s-r~tiktok-profile/run-sync": { "post": { "operationId": "run-sync-s-r-tiktok-profile", "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 accounts", "type": "array", "description": "Handles or profile links, one per line. A link copied from an embedded video works as it is: everything after the handle is ignored, so ?referer_url=...&refer=embed resolves to the same account as a plain @handle. Leave empty when you only want single videos or hashtags.", "items": { "type": "string" } }, "max_videos": { "title": "Maximum videos per account", "minimum": 0, "maximum": 1000, "type": "integer", "description": "How many videos to read per account, newest first. Set to 0 to read only the account details and no videos. The feed returns 35 per request, so this rounds up to whole requests and is the cost ceiling.", "default": 50 }, "max_accounts": { "title": "Maximum accounts", "minimum": 1, "maximum": 200, "type": "integer", "description": "Stop after this many accounts, counted after duplicates are removed.", "default": 25 }, "video_urls": { "title": "Single videos", "type": "array", "description": "Video links or bare video ids to read one by one. The handle in a video link is ignored because the id is what resolves, so a link with a stale handle still works. Returns the same fields as an account's videos, plus the author's follower count at the moment of the run.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to look up, as #tag, tag or a /tag/ link. Returns how many videos carry the tag and how many views they have between them. TikTok does not serve the tag's video list to anyone, so this is reach figures only and the run says so rather than returning an empty list.", "items": { "type": "string" } }, "related_to": { "title": "Related videos", "type": "array", "description": "Seed video links or bare ids. For each, returns the videos TikTok lists as related, about 16 per seed, each a full record with its own author and stats and a seed_video_id column. A cheap way to widen coverage from a starting video without a login.", "items": { "type": "string" } }, "explore": { "title": "Explore feed videos", "minimum": 0, "maximum": 30, "type": "integer", "description": "How many videos to pull from TikTok's public Explore/discover feed. 0 disables it. Note: unlike the other modes this endpoint may require the signed browser path; when it refuses, the run reports the reason rather than an empty feed.", "default": 0 }, "explore_category": { "title": "Explore category", "type": "string", "description": "Optional Explore category id (categoryType). Leave as 0 for the default mixed feed.", "default": "0" } } }, "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 } } } } } } } } } }