{ "openapi": "3.0.1", "info": { "title": "TikTok Email Scraper: Creator Contacts, Socials, Bio Links", "description": "TikTok email finder for influencer outreach: $0.007 per creator with a public email, free when none is found. Give @handles, profile or video URLs; get the bio email, bio link, website email, Instagram, YouTube, followers and likes. No login, no CAPTCHA.", "version": "0.1", "x-build-id": "wUA1Ojiz02iO8hiCW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datagleaner~tiktok-contacts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datagleaner-tiktok-contacts", "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/datagleaner~tiktok-contacts/runs": { "post": { "operationId": "runs-sync-datagleaner-tiktok-contacts", "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/datagleaner~tiktok-contacts/run-sync": { "post": { "operationId": "run-sync-datagleaner-tiktok-contacts", "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": { "profiles": { "title": "Profiles", "type": "array", "description": "TikTok @handles or profile URLs, one per line, e.g. `@cookingwithlynja` or `https://www.tiktok.com/@cookingwithlynja`. A video link works too: it stands for the creator who posted it. Leave this and the video URLs empty to run 3 sample creators.", "items": { "type": "string" } }, "videoUrls": { "title": "Video URLs", "type": "array", "description": "TikTok video links, including short vm.tiktok.com links. Each resolves to its author, whose contacts are returned. The video's posting country fills `region`.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (from another Actor)", "type": "string", "description": "Optional. Read TikTok creators from this dataset, for example TikTok Scraper results, and add them to the profiles above. Each item's `authorMeta.name` or `authorMeta.profileUrl` (or `webVideoUrl`, `uniqueId`, `username`, `profileUrl`, `input`) is used; items without one are skipped. In an integration use `{{resource.defaultDatasetId}}`." }, "datasetField": { "title": "Profile field in the dataset", "type": "string", "description": "Optional. Name of the field (dots reach into objects, e.g. `author.handle`) that holds the creator's handle or profile URL when it is not one of the usual ones. Tried first." }, "maxDatasetItems": { "title": "Max creators from the dataset", "minimum": 1, "type": "integer", "description": "Read at most this many distinct creators from the dataset. Several videos of one creator count once.", "default": 1000 }, "followLinks": { "title": "Follow the bio link", "type": "boolean", "description": "Visit the creator's bio link (and at most one more page: their website from a link-in-bio page, or the website's contact page) and collect the emails and socials shown there. Linktree, Beacons and solo.to block automated clients, so those links are returned without being visited.", "default": true }, "onlyWithEmail": { "title": "Only creators with an email", "type": "boolean", "description": "Output only creators where at least one public email was found. Creators without an email are free either way.", "default": false }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Skip creators with fewer followers. Skipped creators are not billed and do not appear in the output." }, "maxConcurrency": { "title": "Creators in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many creators are processed at the same time. Keep it low; TikTok slows down heavy traffic from one IP.", "default": 3 }, "delaySecs": { "title": "Pacing (seconds)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Each creator starts after a random pause of up to this many seconds. Raise it on very large runs to stay polite.", "default": 2 }, "respectRobotsTxt": { "title": "Respect robots.txt on followed sites", "type": "boolean", "description": "Skip website pages that the site's robots.txt disallows.", "default": true }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for each page before retrying.", "default": 30 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Defaults to no proxy: TikTok profile pages load from Apify's own servers. Add a proxy only if a very large run starts returning errors." } } }, "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 } } } } } } } } } }