{
"openapi": "3.0.1",
"info": {
"title": "TikTok Profile Scraper: Creator Stats, Bio, Emails & Posts",
"description": "Fast 256MB TikTok Profile Scraper. Extract follower count, total likes, bio, bioLink, verified badge, TikTok Shop seller status, extracted business emails, and latest posts by username or URL. Works with public & private profiles. Zero proxies needed.",
"version": "1.0",
"x-build-id": "zb1aTVTnmiA9SVAka"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/church_of_loujess~tiktok-profile-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-church_of_loujess-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/church_of_loujess~tiktok-profile-scraper/runs": {
"post": {
"operationId": "runs-sync-church_of_loujess-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/church_of_loujess~tiktok-profile-scraper/run-sync": {
"post": {
"operationId": "run-sync-church_of_loujess-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": {
"profiles": {
"title": "TikTok Profiles / Usernames",
"type": "array",
"description": "TikTok usernames to scrape: bare handles (nasa), @handle, or full profile URLs (https://www.tiktok.com/@nasa). Duplicates are automatically removed.",
"default": [
"khaby.lame",
"nasa",
"zachking",
"charlidamelio"
],
"items": {
"type": "string"
}
},
"usernames": {
"title": "TikTok Usernames (Alias for Legacy Scrapers)",
"type": "array",
"description": "Optional alias for profiles (compatible with legacy abe/tiktok-profile-scraper inputs). Merged automatically with profiles.",
"default": [],
"items": {
"type": "string"
}
},
"resultsPerPage": {
"title": "Posts per profile",
"minimum": 0,
"maximum": 500,
"type": "integer",
"description": "How many latest posts to return per profile. Set to 0 for profile-only mode (one compact item per handle with full creator metadata & emails). Set to 1 or more to include the creator's newest posts.",
"default": 5
},
"oldestPostDate": {
"title": "Oldest post date (Optional)",
"type": "string",
"description": "Only return posts created on/after this date (ISO format, e.g. 2024-01-01). Leave empty for no date filter."
},
"excludePinnedPosts": {
"title": "Exclude pinned posts",
"type": "boolean",
"description": "If enabled, pinned posts are filtered out when fetching a profile's latest posts.",
"default": false
},
"crawlBioLinkForEmails": {
"title": "Crawl Creator BioLink for Business Emails",
"type": "boolean",
"description": "When enabled, if a creator has an external bioLink (website, Linktree, Beacons, etc.), fetches the landing page to extract business inquiry emails and social links.",
"default": true
},
"includeTranscriptText": {
"title": "Decode Spoken Transcripts on Posts (RAG / LLM Ready)",
"type": "boolean",
"description": "When fetching posts (resultsPerPage >= 1), automatically decode WebVTT subtitle tracks into plain spoken text (transcriptText).",
"default": true
},
"proxyConfiguration": {
"title": "Proxy Configuration (optional)",
"type": "object",
"description": "Optional proxy settings. Works out-of-the-box with zero proxy configuration required.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}