{ "openapi": "3.0.1", "info": { "title": "TikTok Discover Scraper With Search Suggestions", "description": "TikTok Discover Scraper extracts public discovery data, including trending searches, search suggestions, keywords, hashtags, creators, and related content. Analyze emerging topics and search trends to uncover content opportunities, audience interests, and viral trends.", "version": "0.1", "x-build-id": "4VmBvSFP6cDMNTDLq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~tiktok-discover-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-tiktok-discover-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/api-empire~tiktok-discover-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-tiktok-discover-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/api-empire~tiktok-discover-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-tiktok-discover-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "🌱 Seed terms to research", "type": "array", "description": "Plain search terms work best — `protein powder`, `skincare`, `phonk`.\n\nAlso accepted: a hashtag with or without `#`, and a TikTok URL (a `search?q=` link, a `/tag/` link or an `@handle` link — the term or handle is extracted from it).", "items": { "type": "string" } }, "suggestionsOnly": { "title": "🔤 Suggestion rows only — skip the videos", "type": "boolean", "description": "ON → keyword-research mode: suggestion rows only, no browser at all. Fastest and cheapest run.\n\nOFF (default) → you also get the video rows for each seed, capped by the video limit further down.", "default": false }, "expandWithAlphabet": { "title": "🔠 Expand with a–z and 0–9 suffixes", "type": "boolean", "description": "⚠️ Cost warning: this fires up to 37 lookups per seed instead of 1, and a single seed can emit a few hundred charged rows. Leave OFF for a quick look; turn ON when you want a long-tail keyword list.", "default": false }, "expansionCharset": { "title": "🔡 Which suffixes to try", "enum": [ "az09", "az", "09" ], "type": "string", "description": "Only used when alphabet expansion is ON.", "default": "az09" }, "maxSuggestionsPerSeed": { "title": "🔢 Cap suggestion rows per seed", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Hard stop on how many suggestion rows one seed may emit, applied after de-duplication and after the language filter. `0` means no cap.\n\nUseful as a budget guard when alphabet expansion is ON.", "default": 0 }, "suggestionLanguages": { "title": "🌐 Keep only these suggestion languages", "type": "array", "description": "TikTok's own two-letter language tag on each phrase, e.g. `en`, `my`, `it`, `ms`. Leave empty to keep every language.", "items": { "type": "string" } }, "maxItems": { "title": "🎬 Max video rows per seed", "minimum": 0, "maximum": 500, "type": "integer", "description": "How many TikTok videos to pull for each seed from the keyword search feed.\n\n`0` means no cap from you — the run still stops at the platform's own limit.", "default": 10 }, "proxyConfiguration": { "title": "🛡️ Apify Proxy settings", "type": "object", "description": "Turn on Apify Proxy here if you already know you need a specific proxy group up front." } } }, "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 } } } } } } } } } }