{ "openapi": "3.0.1", "info": { "title": "TikTok Creator Search", "description": "Find and scrape TikTok creators by niche, keyword, topic, or brand with an influencer search tool. Discover UGC creators and collect public profile data.", "version": "0.5", "x-build-id": "CGzee5a7734TByzLq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devcake~tiktok-creator-apify/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devcake-tiktok-creator-apify", "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/devcake~tiktok-creator-apify/runs": { "post": { "operationId": "runs-sync-devcake-tiktok-creator-apify", "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/devcake~tiktok-creator-apify/run-sync": { "post": { "operationId": "run-sync-devcake-tiktok-creator-apify", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "minItems": 1, "maxItems": 10, "type": "array", "description": "Enter creator names, usernames, niches, or keywords. Duplicate query strings are removed. Choose Unique creators to combine overlapping creator results across queries.", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "outputMode": { "title": "Result grouping", "enum": [ "perQuery", "unique" ], "type": "string", "description": "Per query preserves the existing output. Unique mode discovers across all queries first, then enriches and saves each creator once, with all matched queries and ranks. Each emitted creator is charged once.", "default": "perQuery" }, "maxCreatorsPerQuery": { "title": "Max creators", "minimum": 20, "maximum": 1000, "type": "integer", "description": "Choose a target of 20 to 1,000 creators for each query. Large searches use additional deduplicated requests, and TikTok may return fewer creators when fewer matching accounts are available.", "default": 20 }, "maxCreators": { "title": "Max unique creators", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Run-wide output limit in Unique creators mode only. First-discovered creators are selected; later searches still add matching queries to those creators. Ignored in per-query mode.", "default": 1000 }, "enrichProfiles": { "title": "Enrich profiles", "type": "boolean", "description": "Fetch public profiles to add bio, bio link, followers, following, likes, video count, region, and full avatar URL. When recent posts are also enabled, both features share the same profile request. Successful enrichment retains its existing add-on charge.", "default": false }, "includeRecentPosts": { "title": "Include recent posts", "type": "boolean", "description": "Collect the latest available public videos for every discovered creator, with captions, dates, metrics and permanent links. Adds run time and proxy usage. Unavailable feeds retain their creator row and report a reason. Concurrency is managed automatically.", "default": false }, "maxRecentPostsPerCreator": { "title": "Posts per creator", "minimum": 1, "maximum": 500, "type": "integer", "description": "Choose the maximum number of latest videos to collect per creator (1–500). Privacy, availability and the internal request budget can produce fewer. Used only when Include recent posts is enabled.", "default": 12 } } }, "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 } } } } } } } } } }