{ "openapi": "3.0.1", "info": { "title": "TikTok Creator Search Scraper", "description": "Find TikTok creators by keyword or URL, with full profile enrichment, follower count, bio, verified status, and recent video engagement data. Streams to dataset with webhook support. Perfect for influencer discovery, outreach, and market research.", "version": "0.0", "x-build-id": "9Vx1jrGem0g3atM0r" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~TikTok-Creator-Search-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-TikTok-Creator-Search-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/b2b_leads~TikTok-Creator-Search-Scraper/runs": { "post": { "operationId": "runs-sync-b2b_leads-TikTok-Creator-Search-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/b2b_leads~TikTok-Creator-Search-Scraper/run-sync": { "post": { "operationId": "run-sync-b2b_leads-TikTok-Creator-Search-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": { "kwEnable": { "title": "Discover by keyword", "type": "boolean", "description": "Discover new creators by topic, then load each full profile. Every creator row can also embed their latest videos.", "default": true }, "accountKeywords": { "title": "Keywords", "type": "array", "description": "Topics to search (e.g. cooking, gym tips).", "default": [ "cooking" ], "items": { "type": "string" } }, "accountsPerKeyword": { "title": "Creators per keyword", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum creators to keep from each keyword (1–50).", "default": 15 }, "kwIncludeRecentVideos": { "title": "Include each creator’s recent videos", "type": "boolean", "description": "When on, every discovered creator row also contains their latest videos in a “recentVideos” column.", "default": true }, "kwRecentVideosMax": { "title": "Recent videos per creator", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum recent videos attached to each discovered creator row.", "default": 12 }, "kwVideoEngagement": { "title": "Full video stats", "type": "boolean", "description": "Adds plays, likes, comments, shares, music, duration, and cover to each recent video.", "default": true }, "kwVideoAccountDetails": { "title": "Creator details on each video", "type": "boolean", "description": "Adds the creator’s followers, bio, and verified status onto each recent-video entry.", "default": false }, "kwVideoMinPlays": { "title": "Min plays per video", "minimum": 0, "type": "integer", "description": "Only keep recent videos at or above this play count (0 = no filter).", "default": 0 }, "kwVideoPublishedWithin": { "title": "Published within", "enum": [ "any", "7d", "30d", "90d" ], "type": "string", "description": "Only keep recent videos published in this time window.", "default": "any" }, "urlEnable": { "title": "Discover by username / URL", "type": "boolean", "description": "Look up known creator profiles by handle or profile link. Every creator is saved as one row with full profile and (optionally) recent videos.", "default": false }, "accountUsernames": { "title": "Usernames", "type": "array", "description": "TikTok usernames without @ (e.g. charlidamelio).", "default": [], "items": { "type": "string" } }, "accountUrls": { "title": "Profile links", "type": "array", "description": "Full profile links such as https://www.tiktok.com/@username.", "default": [], "items": { "type": "string" } }, "urlIncludeRecentVideos": { "title": "Include each creator’s recent videos", "type": "boolean", "description": "When on, every creator row also contains their latest videos in a “recentVideos” column — no extra rows are created.", "default": true }, "urlRecentVideosMax": { "title": "Recent videos per creator", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum recent videos attached to each creator row in this section.", "default": 12 }, "urlVideoEngagement": { "title": "Full video stats", "type": "boolean", "description": "Adds plays, likes, comments, shares, music, duration, and cover to each recent video.", "default": true }, "urlVideoAccountDetails": { "title": "Creator details on each video", "type": "boolean", "description": "Adds the creator’s followers, bio, and verified status onto each recent-video entry.", "default": false }, "urlVideoMinPlays": { "title": "Min plays per video", "minimum": 0, "type": "integer", "description": "Only keep recent videos at or above this play count (0 = no filter).", "default": 0 }, "urlVideoPublishedWithin": { "title": "Published within", "enum": [ "any", "7d", "30d", "90d" ], "type": "string", "description": "Only keep recent videos published in this time window.", "default": "any" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. Every creator is always saved to the run’s dataset as it is collected — this webhook is an extra real-time push (CRM, Slack, Zapier, Make, custom API).", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "json = full creator record; slack = short Slack-friendly message.", "default": "json" }, "includeRaw": { "title": "Include raw data", "type": "boolean", "description": "Attach extended source fragments to each record. Larger output — for advanced users only.", "default": false } } }, "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 } } } } } } } } } }