{
"openapi": "3.0.1",
"info": {
"title": "TikTok Influencer Email Finder",
"description": "Find TikTok influencer emails from profiles or a keyword. Get public bio emails with a domain health check, linked-page contacts, social links, followers, likes and verified status.",
"version": "1.1",
"x-build-id": "kOEBE5iPRw0yIig3j"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parsebird~tiktok-influencer-email-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parsebird-tiktok-influencer-email-finder",
"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/parsebird~tiktok-influencer-email-finder/runs": {
"post": {
"operationId": "runs-sync-parsebird-tiktok-influencer-email-finder",
"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/parsebird~tiktok-influencer-email-finder/run-sync": {
"post": {
"operationId": "run-sync-parsebird-tiktok-influencer-email-finder",
"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": [
"target"
],
"properties": {
"target": {
"title": "Find emails from",
"enum": [
"profiles",
"keyword"
],
"type": "string",
"description": "Choose Profiles to scan the TikTok profiles you list, or Keyword to find creator profiles for a keyword. The field for the other choice is ignored.",
"default": "profiles"
},
"profileTargets": {
"title": "TikTok profiles",
"maxItems": 5000,
"type": "array",
"description": "Add TikTok usernames (jamescharles), @handles (@tiktok), or profile URLs (https://www.tiktok.com/@tiktok), one per line. Used when 'Find emails from' is Profiles.",
"items": {
"type": "string"
}
},
"keyword": {
"title": "Keyword",
"maxLength": 100,
"type": "string",
"description": "Enter one niche keyword, such as fitness coach, skincare, or dog trainer. Creators are found from TikTok search suggestions and LIVE search for the keyword and its related search terms. Used when 'Find emails from' is Keyword."
},
"includeLinkedPages": {
"title": "Check linked pages for more contacts",
"type": "boolean",
"description": "Open the website or link-in-bio page linked from each profile, plus up to two follow-up pages such as a contact page, and collect public emails and social links from them. Private or login-gated pages are skipped. Makes each profile slower.",
"default": false
},
"minimumFollowers": {
"title": "Minimum followers",
"minimum": 0,
"type": "integer",
"description": "Only return profiles with at least this many followers. Leave empty to allow any follower count."
},
"maximumFollowers": {
"title": "Maximum followers",
"minimum": 0,
"type": "integer",
"description": "Only return profiles with no more than this many followers. Leave empty to allow any follower count."
},
"verifiedOnly": {
"title": "Verified profiles only",
"type": "boolean",
"description": "Return only profiles that TikTok marks as verified.",
"default": false
},
"requirePublicContact": {
"title": "Profiles with public contact only",
"type": "boolean",
"description": "Return only profiles that show at least one public contact channel: an email, a website, or a social link.",
"default": false
},
"emailDomains": {
"title": "Email domains",
"type": "array",
"description": "Keep only emails on these exact domains, such as gmail.com or brand.com. Profiles without a matching email are skipped. Leave empty to allow every domain.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max profiles",
"minimum": 1,
"type": "integer",
"description": "Stop after saving this many profiles. Leave empty to save every profile found."
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "The default (Apify Proxy, US) works for most runs. Change it only if you know you need different proxies.",
"default": {
"useApifyProxy": true,
"apifyProxyCountry": "US"
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}