{ "openapi": "3.0.1", "info": { "title": "TikTok Creator Search Scraper", "description": "Find TikTok creators by keyword or niche: follower band, median recent views, engagement, language and public contact. One failed handle never stops your batch. Export to JSON, CSV or Excel, or call it as an API. No login needed. For influencer marketing and outreach lists.", "version": "0.1", "x-build-id": "5zKc6XJ0NhkmEpqJO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/om_kh~tiktok-creator-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-om_kh-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/om_kh~tiktok-creator-search-scraper/runs": { "post": { "operationId": "runs-sync-om_kh-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/om_kh~tiktok-creator-search-scraper/run-sync": { "post": { "operationId": "run-sync-om_kh-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": { "keywords": { "title": "Niche keywords", "type": "array", "description": "Niches or hashtags to search for creators in, e.g. 'home coffee roasting'.", "items": { "type": "string" } }, "usernames": { "title": "Usernames", "type": "array", "description": "Creators you already have. Full URL, @handle, or bare handle all work.", "items": { "type": "string" } }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip creators below this follower count." }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Skip creators above this follower count." }, "minMedianRecentViews": { "title": "Minimum median recent views", "minimum": 0, "type": "integer", "description": "Skip creators whose recent videos median below this view count. Filtering happens before billing.", "default": 0 }, "languages": { "title": "Language filter (ISO 639-1)", "type": "array", "description": "Keep only creators in these languages, e.g. en, fr, es. Best-effort against the video's declared language.", "items": { "type": "string" } }, "activeWithinDays": { "title": "Active within (days)", "minimum": 1, "type": "integer", "description": "Exclude creators with no video published in this many days.", "default": 90 }, "requireContact": { "title": "Require public business contact", "type": "boolean", "description": "Only deliver creators where a public business contact was found (TikTok bios rarely carry one — default off).", "default": false }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stop after this many qualified creators.", "default": 100 }, "monitorEnabled": { "title": "Enable monitoring", "type": "boolean", "description": "On later runs with the same Monitor ID, deliver only creators not seen before.", "default": false }, "monitorId": { "title": "Monitor ID", "type": "string", "description": "Groups runs into one monitored target. Leave blank for a one-off run." }, "maxTotalChargeUsd": { "title": "Maximum charge (USD)", "minimum": 0, "type": "number", "description": "Hard ceiling on what this run can bill you." } } }, "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 } } } } } } } } } }