{ "openapi": "3.0.1", "info": { "title": "TokLead AI - Mass TikTok Email & Creator Lead Scraper", "description": "Extract targeted emails, contact phone numbers, bio links, social profiles, and follower counts from TikTok creators and brands by keyword, niche, hashtag, location, or direct username list. Export to CSV, JSON & Excel.", "version": "1.0", "x-build-id": "aV3QrBVMfakHTasSa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_studio~toklead-tiktok-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_studio-toklead-tiktok-email-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/automation_studio~toklead-tiktok-email-scraper/runs": { "post": { "operationId": "runs-sync-automation_studio-toklead-tiktok-email-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/automation_studio~toklead-tiktok-email-scraper/run-sync": { "post": { "operationId": "run-sync-automation_studio-toklead-tiktok-email-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": [ "search_keywords" ], "properties": { "search_keywords": { "title": "Search Keywords & Target Niches", "type": "array", "description": "Enter target niches, creator categories, or keywords to search for TikTok leads (e.g. 'fitness coach', 'ugc creator', 'dropshipping', 'beauty brand', 'real estate').", "items": { "type": "string" } }, "hashtags": { "title": "Target Hashtags (Optional)", "type": "array", "description": "Optional list of TikTok hashtags to target (e.g. '#fitness', '#ugccreator', '#dropshipping', '#fashiontok').", "items": { "type": "string" } }, "direct_usernames": { "title": "Direct TikTok Usernames (Optional)", "type": "array", "description": "Optional list of specific TikTok usernames to target directly (e.g. 'mrbeast', 'gymshark', 'addisonre').", "items": { "type": "string" } }, "location_filter": { "title": "Target Location (Optional)", "type": "string", "description": "Optional geographic filter to narrow results by country or city (e.g. 'United States', 'New York', 'United Kingdom', 'Canada', 'Australia')." }, "email_domains": { "title": "Target Specific Email Domains (Optional)", "type": "array", "description": "Restrict results to certain email providers (e.g. 'gmail.com', 'yahoo.com', 'outlook.com', 'icloud.com'). Leave empty for all domain types.", "items": { "type": "string" } }, "only_custom_domains": { "title": "Only Custom / Private Business Domains", "type": "boolean", "description": "When enabled, skips free email providers (Gmail, Yahoo, Outlook, Hotmail, iCloud) and only collects professional business domain emails like @brand.com, @agency.io — ideal for high-ticket B2B outreach.", "default": false }, "max_results": { "title": "Max Lead Results", "minimum": 5, "maximum": 10000, "type": "integer", "description": "Maximum number of total TikTok creator lead profiles to extract.", "default": 5 }, "only_with_email": { "title": "Only Profiles With Valid Email", "type": "boolean", "description": "When enabled, saves only profiles that contain a validated public email address.", "default": true }, "extract_phone_numbers": { "title": "Extract Phone / WhatsApp Numbers", "type": "boolean", "description": "Extract phone numbers and direct WhatsApp contact links from bio text.", "default": true }, "extract_social_links": { "title": "Extract Bio Social Links", "type": "boolean", "description": "Extract other social profiles (Instagram, YouTube, LinkedIn, Twitter/X, Linktree) found in bio links.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Built-in Apify Proxy configuration. Pre-configured with GOOGLE_SERP for maximum search engine extraction rate.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "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 } } } } } } } } } }