{ "openapi": "3.0.1", "info": { "title": "TikTok User Search Scraper - Find Creators [NO LOGIN] ✅", "description": "Search TikTok users and creators by keyword. Get handles, bios, follower counts, and recent videos. Built for creator discovery, influencer research, and lead generation by topic or niche. No login, no cookies. Pair with our Followers Scraper to map full audiences.", "version": "0.0", "x-build-id": "efvbEh7nHHlWz16ql" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~tiktok-user-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-tiktok-user-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/unseenuser~tiktok-user-search-scraper/runs": { "post": { "operationId": "runs-sync-unseenuser-tiktok-user-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/unseenuser~tiktok-user-search-scraper/run-sync": { "post": { "operationId": "run-sync-unseenuser-tiktok-user-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", "required": [ "queries" ], "properties": { "queries": { "title": "Search queries / usernames", "minItems": 1, "uniqueItems": true, "type": "array", "description": "One or more keywords or usernames to search. Add a single entry for a one-off search, or many entries to run them all in one bulk run. Leading '@' is stripped automatically. Duplicates are removed.", "items": { "type": "string" } }, "max_pages": { "title": "Max pages per query (0 = everything)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum pages of results to fetch per query. Each page returns roughly 10-20 creators. Set to 0 for everything - the Actor walks until the upstream runs out of results (or the free-plan 50-result cap kicks in). Any value 1-100 caps the run at that many pages.", "default": 0 }, "min_follower_count": { "title": "Minimum follower count (0 = no filter)", "minimum": 0, "type": "integer", "description": "Filter out users with fewer followers than this value. Set to 0 for everything - no follower filter is applied. Any value above 0 drops creators below that threshold.", "default": 0 }, "exclude_unverified": { "title": "Exclude unverified accounts", "type": "boolean", "description": "If true, exclude unverified accounts from the results.", "default": false }, "auto_expand_query": { "title": "Auto-expand each query into many variants (recommended)", "type": "boolean", "description": "Default ON. Runs each base query against ~60 variants (e.g. 'Michael' becomes 'Michael fitness', 'Michael fashion', 'Michael nyc', 'Michael london', '@Michael', etc.). Results are de-duplicated by @handle across the whole run, so you typically get 10x-30x more unique creators per base query - which is how you break past TikTok's ~60-100 best-match cap. Turn OFF only when your queries are exact handles (e.g. bulk lookup of a known @handle list) and you do NOT want variant expansion.", "default": true }, "deep_search": { "title": "Search users, videos, and top posts (maximum coverage)", "type": "boolean", "description": "Default ON. Runs each query against three TikTok search surfaces - user profiles, videos by keyword, and Top search - and merges the unique creators. Typically returns 10x-50x more unique creators per query than searching user profiles alone. Each output row's _metadata.source field shows which surface found that creator ('user_search' | 'keyword_video' | 'top_search'). Turn OFF only if you want the strictest user-profile matches and are willing to accept fewer creators per query. Note: creators discovered via video-based surfaces may have follower_count 0 because TikTok's embedded author object is leaner than the user-profile response.", "default": true } } }, "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 } } } } } } } } } }