{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Posts Scraper", "description": "Paste a TikTok profile URL and get that account's videos for any period. Date-range filtering, multi-profile input, auto-pagination. Returns description, author, likes, comments, shares, plays, cover and video URL.", "version": "0.0", "x-build-id": "UYC5Qa2UOZPRSiRlS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/outspoken_strategy~tiktok-profile-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-outspoken_strategy-tiktok-profile-posts-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/outspoken_strategy~tiktok-profile-posts-scraper/runs": { "post": { "operationId": "runs-sync-outspoken_strategy-tiktok-profile-posts-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/outspoken_strategy~tiktok-profile-posts-scraper/run-sync": { "post": { "operationId": "run-sync-outspoken_strategy-tiktok-profile-posts-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": { "profileUrl": { "title": "Profile URL (single)", "type": "string", "description": "The TikTok profile to scrape, e.g. https://www.tiktok.com/@tiktok. An @handle or a bare handle also works, and so does any video URL on the profile (it is resolved to its author). You can paste several profiles, one per line. For a clean list use \"profileUrls\" below instead." }, "profileUrls": { "title": "Profile URLs (multiple)", "type": "array", "description": "Several profiles to scrape — each is scraped separately and the results are combined. \"Number of videos\" applies PER profile.", "items": { "type": "string" } }, "numberOfPosts": { "title": "Number of videos", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of videos to return per profile (after date filtering).", "default": 100 }, "scrapeAll": { "title": "Scrape all (auto-paginate)", "type": "boolean", "description": "Keep scrolling until the target count is reached, the date range is passed, or the feed runs dry. When unchecked only the videos on the initial page load are returned.", "default": true }, "timeSince": { "title": "From date (since)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only return videos published on or after this date (format: yyyy-mm-dd). Inclusive." }, "timeUntil": { "title": "To date (until)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only return videos published on or before this date (format: yyyy-mm-dd). Inclusive." }, "cookies": { "title": "TikTok session cookies", "type": "array", "description": "Cookies of a logged-in TikTok session, exported with a browser extension such as Cookie-Editor (JSON array of {name, value, domain, ...}). Alternatively set the TIKTOK_COOKIES secret environment variable on the actor (same JSON, or a 'name=value; name2=value2' string). Use a throwaway account, never your personal one." }, "region": { "title": "Region", "type": "string", "description": "Country code used for the proxy exit IPs when the proxy configuration has no country of its own (e.g. \"US\", \"GB\", \"ZA\").", "default": "US" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy to route traffic through. RESIDENTIAL proxies with a country set are strongly recommended — TikTok blocks datacenter IPs and flags many anonymous exits.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "headless": { "title": "Run browser headless", "type": "boolean", "description": "Uncheck to run a headed browser (useful only for local debugging).", "default": true } } }, "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 } } } } } } } } } }