{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Creator Insights Scraper Across Every Country", "description": "Discover top viral accounts fast with this TikTok Trending Creator Scraper 🔥 Extract creator profiles, follower counts, engagement metrics, video stats, and trending insights in seconds 📊 Perfect for influencer research, competitor analysis, and trend tracking 🔍🚀", "version": "0.1", "x-build-id": "VxUuztMR1PYEcorLn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~tiktok-trending-creator-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-tiktok-trending-creator-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/scrapio~tiktok-trending-creator-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-tiktok-trending-creator-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/scrapio~tiktok-trending-creator-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-tiktok-trending-creator-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": [ "countryCode", "sortBy" ], "properties": { "markets": { "title": "Markets to sweep (multi-select)", "type": "array", "description": "Pick every country board you want swept. Empty = fall back to the single Country field.", "items": { "type": "string", "enum": [ "AR", "AU", "BR", "CA", "CO", "EG", "FR", "DE", "ID", "IL", "IT", "JP", "MY", "MX", "PH", "RU", "SA", "SG", "ZA", "KR", "ES", "TW", "TH", "TR", "AE", "GB", "US", "VN" ], "enumTitles": [ "Argentina (AR)", "Australia (AU)", "Brazil (BR)", "Canada (CA)", "Colombia (CO)", "Egypt (EG)", "France (FR)", "Germany (DE)", "Indonesia (ID)", "Israel (IL)", "Italy (IT)", "Japan (JP)", "Malaysia (MY)", "Mexico (MX)", "Philippines (PH)", "Russia (RU) - mirrors the US board", "Saudi Arabia (SA)", "Singapore (SG)", "South Africa (ZA)", "South Korea (KR)", "Spain (ES)", "Taiwan (TW)", "Thailand (TH)", "Turkey (TR)", "United Arab Emirates (AE)", "United Kingdom (GB)", "United States (US)", "Vietnam (VN)" ] }, "default": [] }, "sweepAllMarkets": { "title": "Sweep all 27 supported markets", "type": "boolean", "description": "Overrides the two market fields and runs every supported market: 27 real boards (RU is skipped as a US mirror) x the windows you select, 9 creator rows per slice.", "default": false }, "countryCode": { "title": "Country (single-market fallback)", "enum": [ "AR", "AU", "BR", "CA", "CO", "EG", "FR", "DE", "ID", "IL", "IT", "JP", "MY", "MX", "PH", "RU", "SA", "SG", "ZA", "KR", "ES", "TW", "TH", "TR", "AE", "GB", "US", "VN" ], "type": "string", "description": "Used when the multi-select above is empty and the sweep-all toggle is off. AR, CO, MX and ZA are supported upstream and are exposed here for the first time.", "default": "US" }, "periods": { "title": "Trend windows (days)", "type": "array", "description": "Upstream supports exactly 7, 30 and 90 days.", "items": { "type": "string", "enum": [ "7", "30", "90" ], "enumTitles": [ "Last 7 days", "Last 30 days", "Last 90 days" ] }, "default": [ "7" ] }, "enrichmentLevel": { "title": "Enrichment depth", "enum": [ "board", "profile", "full" ], "type": "string", "description": "board = board fields only (total likes null, video array empty). profile = adds the exact total-likes figure from the creator profile. full = also fills the video array with real per-video views, likes and timestamps.", "default": "full" }, "maxVideosPerCreator": { "title": "Videos to fetch per creator", "minimum": 0, "maximum": 12, "type": "integer", "description": "Only used at 'full' depth. Each video costs one extra request. The creator video feed returns at most 13 ids and some accounts return none.", "default": 3 }, "requestDelaySeconds": { "title": "Delay between www.tiktok.com requests (seconds)", "minimum": 0, "maximum": 15, "type": "number", "description": "Profile and video requests answer HTTP 503 when hammered. 2.5 s measured stable; lower it at your own risk.", "default": 2.5 }, "followerCount": { "title": "Follower bucket filter", "enum": [ "10k-100k", "100k-1m", "1m-10m", ">10m" ], "type": "string", "description": "Client-side filter over the merged sweep, applied before anything is charged. Leave empty for no filter." }, "sortBy": { "title": "Order the merged results by", "enum": [ "follower", "engagement", "popularity" ], "type": "string", "description": "The board has no sort parameter, so this orders the merged, de-duplicated set locally. Follower = board follower count. Popularity = views on the hashtag that surfaced the creator. Engagement = (likes+comments+shares)/views over the fetched videos, needs 'full' depth.", "default": "follower" }, "maxItems": { "title": "Max creators to return", "minimum": 1, "maximum": 729, "type": "integer", "description": "Hard ceiling of the surface: 3 hashtags x 3 creators = 9 rows per market/window slice, and there is no page 2. 27 markets x 3 windows = 729 rows before de-duplication, which is why the cap is 729.", "default": 10 }, "includeChartEntries": { "title": "Include the per-market chart entry breakdown", "type": "boolean", "description": "Adds chartEntries[] to every row: one entry per market/window/hashtag the creator charted in, with its rank.", "default": true }, "writeMarketRollup": { "title": "Write the market coverage rollup", "type": "boolean", "description": "Stores a per-market rollup (creators found, rank distribution, whether the market returned data, whether it fell back) to the MARKET_COVERAGE key-value record and an uncharged market-coverage dataset.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Your selection is used exactly as given - this Actor never silently upgrades you to a residential group." } } }, "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 } } } } } } } } } }