{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Creator Insights Scraper With Sponsored Videos", "description": "Scrapes insights from trending TikTok creators, capturing profiles, bios, follower growth, engagement rates, top videos, hashtags, sounds, and performance trends. Ideal for influencer discovery, trend forecasting, competitor analysis, and automated creator analytics at scale", "version": "0.1", "x-build-id": "JfRrSMMwSZaZ89dlS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~tiktok-trending-creator-insights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-tiktok-trending-creator-insights-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-insights-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-tiktok-trending-creator-insights-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-insights-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-tiktok-trending-creator-insights-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": { "creatorRegion": { "title": "📍 Creator home region", "enum": [ "All countries", "Australia", "Brazil", "Canada", "Egypt", "France", "Germany", "Indonesia", "Israel", "Italy", "Japan", "Malaysia", "Philippines", "Russia", "Saudi Arabia", "Singapore", "South Korea", "Spain", "Taiwan", "Thailand", "Turkey", "United Arab Emirates", "United Kingdom", "United States", "Vietnam" ], "type": "string", "description": "Optional client-side filter on the creator living/store region after public rank lists are fetched.", "default": "All countries" }, "countryCode": { "title": "🌍 Country (base compatibility)", "enum": [ "All countries", "Australia", "Brazil", "Canada", "Egypt", "France", "Germany", "Indonesia", "Israel", "Italy", "Japan", "Malaysia", "Philippines", "Russia", "Saudi Arabia", "Singapore", "South Korea", "Spain", "Taiwan", "Thailand", "Turkey", "United Arab Emirates", "United Kingdom", "United States", "Vietnam" ], "type": "string", "description": "Legacy base input key. creatorRegion wins when both are set.", "default": "All countries" }, "rankCreatorsBy": { "title": "📊 Rank creators by metric", "enum": [ "popularity", "follower", "engagement", "avg_views" ], "type": "string", "description": "Client-side sort applied after merging public rank lists.", "default": "popularity" }, "sortBy": { "title": "🔥 Sort By (base compatibility)", "enum": [ "popularity", "follower", "engagement", "avg_views" ], "type": "string", "description": "Legacy base input key. rankCreatorsBy wins when both are set.", "default": "popularity" }, "audienceSizeBucket": { "title": "👥 Audience size bucket", "enum": [ "10K-100K", "100K-1M", "1M-10M", ">10M" ], "type": "string", "description": "Optional client-side follower bucket applied after fetch." }, "followerCount": { "title": "👥 Follower Count Range (base compatibility)", "enum": [ "10K-100K", "100K-1M", "1M-10M", ">10M" ], "type": "string", "description": "Legacy base input key for follower bucket filtering." }, "creatorLimit": { "title": "🎯 Creator limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum creator rows to return after dedupe, filters, and sorting.", "default": 10 }, "maxItems": { "title": "🎯 Max Items (base compatibility)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Legacy base input key for maximum creator rows.", "default": 10 }, "contentFilter": { "title": "🏷️ Brand content filter", "enum": [ "all", "hasSponsoredVideos", "hasBoostedVideos", "highBrandedEngagement" ], "type": "string", "description": "Client-side creator filter: all, hasSponsoredVideos, hasBoostedVideos, or highBrandedEngagement (branded ER ≥ organic ER).", "default": "all" }, "emitVideoRows": { "title": "🎬 Emit flat video rows dataset", "type": "boolean", "description": "When enabled, every top/recent/sponsored sample video is also pushed to a named child dataset called videos.", "default": true }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Routes HTTP requests through Apify Proxy when enabled." } } }, "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 } } } } } } } } } }