{ "openapi": "3.0.1", "info": { "title": "TikTok Scraper API – Stats, Transcripts & Profiles, No Login", "description": "Get TikTok video stats, view count, engagement rate, transcripts (captions) and exact follower count from links or usernames, no login. Likes, comments, shares, saves, creator average views. $0.25 per 1,000 videos, 300 free monthly. Up to 10 videos per profile. No keyword search.", "version": "0.2", "x-build-id": "VhNJ3FEyHKKNsxbgD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/k-data-lab~tiktok-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-k-data-lab-tiktok-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/k-data-lab~tiktok-scraper/runs": { "post": { "operationId": "runs-sync-k-data-lab-tiktok-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/k-data-lab~tiktok-scraper/run-sync": { "post": { "operationId": "run-sync-k-data-lab-tiktok-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": { "videoUrls": { "title": "Video links or IDs", "type": "array", "description": "Public TikTok video or photo post links, short vm.tiktok.com links, or numeric video IDs, one per line. Each returns one row with view count, likes, comments, shares, saves, engagement rate, music and author stats. No limit on how many. Example: https://www.tiktok.com/@scout2015/video/6718335390845095173", "items": { "type": "string" } }, "profiles": { "title": "Profiles", "type": "array", "description": "Usernames or profile links, one per line. Each returns one profile row (exact follower count, total likes, video count, bio, plus average views and engagement rate of the videos read) and the videos on the creator's public embed page, up to 10. Examples: tiktok, @nasa, https://www.tiktok.com/@natgeo", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags with or without #, one per line. Each returns one hashtag row (total views, video count) plus top videos, up to 10. TikTok's public hashtag page does not answer for every hashtag at all times: those report UNAVAILABLE in RUN_SUMMARY and are not charged. Example: cooking", "items": { "type": "string" } }, "sounds": { "title": "Sounds", "type": "array", "description": "Sound links or numeric sound IDs (the musicId field of any video row), one per line. Each returns one sound row (videos using it) plus top videos using it, up to 10. Example: https://www.tiktok.com/music/original-sound-6689804660171082501", "items": { "type": "string" } }, "maxVideosPerSource": { "title": "Max videos per profile, hashtag or sound", "minimum": 0, "maximum": 10, "type": "integer", "description": "1 to 10. TikTok's public pages show at most 10 videos here. Higher gives steadier creator averages. Use 0 for summary rows only, the cheapest way to track follower counts of many creators (average views and engagement rate stay empty).", "default": 10 }, "includeSummaryRows": { "title": "Add a summary row per profile, hashtag and sound", "type": "boolean", "description": "One row with the totals for each profile, hashtag and sound. Turn off to get video rows only.", "default": true }, "includeTranscript": { "title": "Add transcripts (TikTok captions / subtitles)", "type": "boolean", "description": "Adds the transcript text from TikTok's own captions when the video has them (hasCaptions in the row). Charged only for rows that get a transcript. No speech-to-text: videos without captions stay empty.", "default": false }, "transcriptLanguage": { "title": "Preferred transcript language", "type": "string", "description": "Start of a language code. If the video has no such track, the first available one is used. Example: eng" }, "publishedAfter": { "title": "Only videos published after", "type": "string", "description": "A date like 2026-11-01. Older videos are dropped and not charged. Free filter." }, "minViews": { "title": "Minimum views", "minimum": 0, "type": "integer", "description": "Drops videos with fewer views, not charged. Free filter." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Drops videos with fewer likes, not charged. Free filter." }, "monitorName": { "title": "Monitor name (only new videos)", "type": "string", "description": "Any name. Runs with the same name skip videos returned before, so a scheduled run gives only new ones and repeats cost nothing. Example: competitors-daily" } } }, "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 } } } } } } } } } }