{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Scraper & TikTok Influencer Email Finder", "description": "TikTok profile scraper and TikTok email finder for creator profiles and influencer contacts (not videos). Search by niche or paste handles: email, Instagram, YouTube, WhatsApp, followers, TikTok Shop status. Pay only for leads.", "version": "1.0", "x-build-id": "Nk6gP62iLt5v6daY4" }, "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": "Search keywords, niches, 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 (optional)", "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" } }, "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" } }, "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 }, "enrichBioLinks": { "title": "Read bio link pages for emails and socials", "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": "Include rows for handles that could not be read", "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 } } } } } } } } } }