{ "openapi": "3.0.1", "info": { "title": "Tiktok Trending Hashtags Scraper", "description": "Tiktok Trending Hashtags Scraper helps you track real-time viral tags, engagement stats, and growth patterns. Scrape trending hashtags, discover niche opportunities, and fuel your content strategy with accurate, fast, structured data. Get reliable data for research workflows.", "version": "0.1", "x-build-id": "Ucl0CjjOJpe0vFy1a" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~tiktok-trending-hashtags-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-tiktok-trending-hashtags-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-trending-hashtags-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-tiktok-trending-hashtags-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-trending-hashtags-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-tiktok-trending-hashtags-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": { "result_type": { "title": "🎯 Result Type", "enum": [ "top100", "top100_with_analytics", "analytics" ], "type": "string", "description": "✨ **Choose what the scraper should return.**\n\nβ€’ πŸ† **Top 100 Ranking** β€” Just the trending list.\nβ€’ πŸ“Š **Top 100 + Analytics** β€” Trending list with deep per-hashtag stats.\nβ€’ πŸ”¬ **Hashtag Analytics** β€” Analytics for your own hashtags (use `Hashtag List` below).", "default": "top100" }, "country": { "title": "🌍 Country", "enum": [ "ALL", "AL", "AR", "AU", "AT", "BH", "BD", "BY", "BE", "BR", "BG", "KH", "CA", "CL", "CO", "HR", "CZ", "DK", "EG", "EE", "FI", "FR", "DE", "GR", "HU", "IS", "ID", "IQ", "IE", "IL", "IT", "JP", "JO", "KZ", "KW", "LV", "LB", "LT", "LU", "MO", "MY", "MX", "MA", "MN", "NL", "NZ", "NG", "NO", "OM", "PK", "PE", "PH", "PL", "PT", "QA", "RO", "SA", "SG", "SK", "ZA", "KR", "ES", "SE", "CH", "TW", "TH", "TR", "UA", "AE", "GB", "US", "UZ", "VN" ], "type": "string", "description": "πŸ—ΊοΈ **Pick a country** (or 🌐 *All* for global trends) to retrieve the top 100 ranking and analytics from.", "default": "ALL" }, "top100_period": { "title": "πŸ“… Top 100 Period", "enum": [ "7", "30", "120" ], "type": "string", "description": "⏳ **Time window** for the Top 100 ranking. Used by `πŸ† Top 100` and `πŸ“Š Top 100 + Analytics`.", "default": "7" }, "analytics_period": { "title": "πŸ“ˆ Analytics Period", "enum": [ "7", "30", "120", "365", "1095" ], "type": "string", "description": "πŸ”­ **Time window for analytics curves** (trend history, engagement growth, etc). Used by `πŸ”¬ Hashtag Analytics`.", "default": "30" }, "top100_industry": { "title": "🏷️ Industry Filter", "enum": [ "", "1000000001", "2000000001", "3000000000", "5000000000", "7000000000", "8000000002", "9000000002", "10000000000", "14000000000", "15000000001", "17000000002", "20000000001", "21000000000", "23000000000", "24000000000", "26000000001", "28000000001", "29000000001" ], "type": "string", "description": "🎨 **Narrow the Top 100 ranking by industry** (TikTok Creative Center categories). Leave on 🌐 *All Industries* to skip filtering.", "default": "" }, "top100_new_on_board": { "title": "πŸ†• New on Board Only", "type": "boolean", "description": "✨ **Enable** to return *only* hashtags that **newly entered** the Top 100 in the chosen period β€” perfect for spotting fresh trends πŸš€.", "default": false }, "hashtag_list": { "title": "#️⃣ Hashtag List", "uniqueItems": true, "type": "array", "description": "πŸ“ **Add your own hashtags** (without the `#`) to fetch analytics for. βš™οΈ Only used when **Result Type** = `πŸ”¬ Hashtag Analytics`.\n\n⚠️ If a hashtag isn't popular enough in the selected country & period, TikTok returns no data for it.", "default": [], "items": { "type": "string" } }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy Configuration", "type": "object", "description": "πŸ›°οΈ Choose which proxies to use. By default, **no proxy** is used. If TikTok rejects a request, the actor falls back to **datacenter proxy**, then **residential proxy** automatically." } } }, "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 } } } } } } } } } }