{ "openapi": "3.0.1", "info": { "title": "TikTok Email Finder: TikTok Influencer Email Finder by Username", "description": "TikTok email finder and TikTok profile scraper for influencer and creator emails, plus Instagram, YouTube and WhatsApp links, followers and TikTok Shop status. Search creators by niche or paste usernames (user scraper, profile data, not videos). Pay only for leads.", "version": "1.0", "x-build-id": "Yf4yucncXaZPkbrmf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrape-lads~tiktok-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrape-lads-tiktok-profile-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/scrape-lads~tiktok-profile-scraper/runs": { "post": { "operationId": "runs-sync-scrape-lads-tiktok-profile-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/scrape-lads~tiktok-profile-scraper/run-sync": { "post": { "operationId": "run-sync-scrape-lads-tiktok-profile-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": { "searchKeywords": { "title": "Keywords or hashtags", "type": "array", "description": "Find creators by topic, for example \"fitness coach\", \"skincare routine\", or \"#booktok\". Each keyword is matched to TikTok topic pages and tried with common variations (tips, influencer, routine, and more) until enough creators are found. Two- or three-word phrases work best. Leave empty to look up only the handles below.", "items": { "type": "string" } }, "handles": { "title": "TikTok handles or profile URLs", "type": "array", "description": "Already have a list? Paste @username, username, or full profile URLs. They are looked up as well as any keyword search.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many saved rows: leads in leads-only mode, profiles otherwise. Start small on your first run.", "default": 100 }, "onlyWithEmail": { "title": "Only creators with a contact email (pay per lead)", "type": "boolean", "description": "Save and charge only creators who publish a contact email; creators without one are checked for free. When left unset it is on for keyword searches and off for handle lists. Switch it off to get every profile." }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip creators with fewer followers than this. Leave empty for no minimum." }, "maxFollowers": { "title": "Maximum followers", "minimum": 0, "type": "integer", "description": "Skip creators with more followers than this, for example 100000 for micro-influencers. Leave empty or 0 for no maximum." }, "languages": { "title": "Account languages", "type": "array", "description": "Keep only accounts whose TikTok language matches one of these codes, for example \"en\", \"es\", or \"de\". Leave empty for any language. TikTok does not publish an account country, so language is the closest location filter.", "items": { "type": "string" } }, "enrichBioLinks": { "title": "Read link-in-bio pages", "type": "boolean", "description": "Open the website or link-in-bio page under each bio and add the emails and social profiles published there. Turn off for the fastest run on bio text alone (fewer leads).", "default": true }, "includeUnavailable": { "title": "Add rows for handles not found", "type": "boolean", "description": "Add an \"unavailable\" row (not charged) for every pasted handle that was not found or stayed blocked, so you can match the output back to your input list.", "default": false }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Parallel requests. The default suits most runs; lower it if you see many retries.", "default": 20 } } }, "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 } } } } } } } } } }