{ "openapi": "3.0.1", "info": { "title": "Tiktok Poster", "description": "Automate posting videos to TikTok! Upload videos with captions, hashtags, and privacy settings. \nFeatures\nVideo Upload - Post videos from URL\nCaptions & Hashtags - Add descriptions and tags\nPrivacy Controls - Set visibility, comments, duet, stitch\nAuto-download - Automatically fetches video from URL", "version": "1.1", "x-build-id": "lwlqtUVGeONLlgLWn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alizarin_refrigerator-owner~tiktok-poster/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alizarin_refrigerator-owner-tiktok-poster", "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/alizarin_refrigerator-owner~tiktok-poster/runs": { "post": { "operationId": "runs-sync-alizarin_refrigerator-owner-tiktok-poster", "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/alizarin_refrigerator-owner~tiktok-poster/run-sync": { "post": { "operationId": "run-sync-alizarin_refrigerator-owner-tiktok-poster", "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": { "username": { "title": "TikTok Username/Email", "type": "string", "description": "TikTok account username or email" }, "password": { "title": "Password", "type": "string", "description": "TikTok account password" }, "cookies": { "title": "Cookies (JSON)", "type": "string", "description": "Exported cookies from logged-in session (strongly recommended - TikTok has aggressive bot detection)" }, "videoUrl": { "title": "Video URL", "type": "string", "description": "URL of the video file to upload (MP4 recommended)" }, "caption": { "title": "Caption", "maxLength": 2200, "type": "string", "description": "Caption for your video (max 2200 characters)" }, "hashtags": { "title": "Hashtags", "type": "array", "description": "Hashtags to add (without # prefix)", "items": { "type": "string" } }, "allowComments": { "title": "Allow Comments", "type": "boolean", "description": "Allow comments on the video", "default": true }, "allowDuet": { "title": "Allow Duet", "type": "boolean", "description": "Allow others to duet with this video", "default": true }, "allowStitch": { "title": "Allow Stitch", "type": "boolean", "description": "Allow others to stitch this video", "default": true }, "isPrivate": { "title": "Private Video", "type": "boolean", "description": "Make the video private (only you can see it)", "default": false }, "timeout": { "title": "Timeout (seconds)", "minimum": 60, "maximum": 600, "type": "integer", "description": "Maximum time to wait for the video upload to complete", "default": 180 }, "demoMode": { "title": "Demo Mode", "type": "boolean", "description": "Run in demo mode without real credentials. Returns mock success response for testing.", "default": true }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL to receive a POST request when the actor run finishes. Useful for integrations with Zapier, Make, n8n, or custom automation workflows." }, "indexNowKey": { "title": "IndexNow API Key", "type": "string", "description": "Optional IndexNow API key for instant search engine indexing of posted content. Get your key at https://www.bing.com/indexnow" }, "cookieStorageKey": { "title": "Cookie Manager Storage Key", "type": "string", "description": "Key to load cookies from the Cookie Manager's Named KV Store. Use this instead of manually pasting cookies. Run Cookie Manager in 'capture' mode first to store cookies, then reference the same storageKey here." }, "cookieKvStoreName": { "title": "Cookie KV Store Name", "type": "string", "description": "Name of the Named Key-Value Store where Cookie Manager saved the session. Defaults to 'cookie-sessions'.", "default": "cookie-sessions" } } }, "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 } } } } } } } } } }