{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Hashtags Scraper By Country And Industry", "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": "D9jMuPVVMuiMOi3oE" }, "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": { "resultType": { "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 per-hashtag stats (trend curve, top creators).\nโ€ข ๐Ÿ”ฌ Hashtag Analytics (Custom List) โ€” analytics for your own hashtags (see 'Hashtags To Analyze' below).\n\nAlso accepts the base's legacy `result_type` key." }, "targetCountries": { "title": "๐ŸŒ Target Countries (multi-select)", "type": "array", "description": "๐Ÿ—บ๏ธ Pick ONE OR MORE countries to compare in the SAME run (upgrade over the base's single-select `country`). Each output row is tagged with its `sourceCountry` so you can compare markets side-by-side. Also accepts the base's legacy single-string `country` key (auto-wrapped into a 1-item list). Leave empty to default to ๐ŸŒ All (Global).", "items": { "type": "string", "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" ], "enumTitles": [ "๐ŸŒ All Countries (Global)", "๐Ÿ‡ฆ๐Ÿ‡ฑ Albania", "๐Ÿ‡ฆ๐Ÿ‡ท Argentina", "๐Ÿ‡ฆ๐Ÿ‡บ Australia", "๐Ÿ‡ฆ๐Ÿ‡น Austria", "๐Ÿ‡ง๐Ÿ‡ญ Bahrain", "๐Ÿ‡ง๐Ÿ‡ฉ Bangladesh", "๐Ÿ‡ง๐Ÿ‡พ Belarus", "๐Ÿ‡ง๐Ÿ‡ช Belgium", "๐Ÿ‡ง๐Ÿ‡ท Brazil", "๐Ÿ‡ง๐Ÿ‡ฌ Bulgaria", "๐Ÿ‡ฐ๐Ÿ‡ญ Cambodia", "๐Ÿ‡จ๐Ÿ‡ฆ Canada", "๐Ÿ‡จ๐Ÿ‡ฑ Chile", "๐Ÿ‡จ๐Ÿ‡ด Colombia", "๐Ÿ‡ญ๐Ÿ‡ท Croatia", "๐Ÿ‡จ๐Ÿ‡ฟ Czech Republic", "๐Ÿ‡ฉ๐Ÿ‡ฐ Denmark", "๐Ÿ‡ช๐Ÿ‡ฌ Egypt", "๐Ÿ‡ช๐Ÿ‡ช Estonia", "๐Ÿ‡ซ๐Ÿ‡ฎ Finland", "๐Ÿ‡ซ๐Ÿ‡ท France", "๐Ÿ‡ฉ๐Ÿ‡ช Germany", "๐Ÿ‡ฌ๐Ÿ‡ท Greece", "๐Ÿ‡ญ๐Ÿ‡บ Hungary", "๐Ÿ‡ฎ๐Ÿ‡ธ Iceland", "๐Ÿ‡ฎ๐Ÿ‡ฉ Indonesia", "๐Ÿ‡ฎ๐Ÿ‡ถ Iraq", "๐Ÿ‡ฎ๐Ÿ‡ช Ireland", "๐Ÿ‡ฎ๐Ÿ‡ฑ Israel", "๐Ÿ‡ฎ๐Ÿ‡น Italy", "๐Ÿ‡ฏ๐Ÿ‡ต Japan", "๐Ÿ‡ฏ๐Ÿ‡ด Jordan", "๐Ÿ‡ฐ๐Ÿ‡ฟ Kazakhstan", "๐Ÿ‡ฐ๐Ÿ‡ผ Kuwait", "๐Ÿ‡ฑ๐Ÿ‡ป Latvia", "๐Ÿ‡ฑ๐Ÿ‡ง Lebanon", "๐Ÿ‡ฑ๐Ÿ‡น Lithuania", "๐Ÿ‡ฑ๐Ÿ‡บ Luxembourg", "๐Ÿ‡ฒ๐Ÿ‡ด Macao", "๐Ÿ‡ฒ๐Ÿ‡พ Malaysia", "๐Ÿ‡ฒ๐Ÿ‡ฝ Mexico", "๐Ÿ‡ฒ๐Ÿ‡ฆ Morocco", "๐Ÿ‡ฒ๐Ÿ‡ณ Mongolia", "๐Ÿ‡ณ๐Ÿ‡ฑ Netherlands", "๐Ÿ‡ณ๐Ÿ‡ฟ New Zealand", "๐Ÿ‡ณ๐Ÿ‡ฌ Nigeria", "๐Ÿ‡ณ๐Ÿ‡ด Norway", "๐Ÿ‡ด๐Ÿ‡ฒ Oman", "๐Ÿ‡ต๐Ÿ‡ฐ Pakistan", "๐Ÿ‡ต๐Ÿ‡ช Peru", "๐Ÿ‡ต๐Ÿ‡ญ Philippines", "๐Ÿ‡ต๐Ÿ‡ฑ Poland", "๐Ÿ‡ต๐Ÿ‡น Portugal", "๐Ÿ‡ถ๐Ÿ‡ฆ Qatar", "๐Ÿ‡ท๐Ÿ‡ด Romania", "๐Ÿ‡ธ๐Ÿ‡ฆ Saudi Arabia", "๐Ÿ‡ธ๐Ÿ‡ฌ Singapore", "๐Ÿ‡ธ๐Ÿ‡ฐ Slovakia", "๐Ÿ‡ฟ๐Ÿ‡ฆ South Africa", "๐Ÿ‡ฐ๐Ÿ‡ท South Korea", "๐Ÿ‡ช๐Ÿ‡ธ Spain", "๐Ÿ‡ธ๐Ÿ‡ช Sweden", "๐Ÿ‡จ๐Ÿ‡ญ Switzerland", "๐Ÿ‡น๐Ÿ‡ผ Taiwan", "๐Ÿ‡น๐Ÿ‡ญ Thailand", "๐Ÿ‡น๐Ÿ‡ท Turkey", "๐Ÿ‡บ๐Ÿ‡ฆ Ukraine", "๐Ÿ‡ฆ๐Ÿ‡ช United Arab Emirates", "๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom", "๐Ÿ‡บ๐Ÿ‡ธ United States", "๐Ÿ‡บ๐Ÿ‡ฟ Uzbekistan", "๐Ÿ‡ป๐Ÿ‡ณ Vietnam" ] } }, "targetIndustries": { "title": "๐Ÿท๏ธ Target Industries (multi-select)", "type": "array", "description": "๐ŸŽจ Pick ONE OR MORE Creative Center industries to compare in the SAME run (upgrade over the base's single-select `top100_industry`). Each output row is tagged with its `sourceIndustry`. Also accepts the base's legacy single-string `top100_industry` key. Leave empty to default to ๐ŸŒ All Industries.", "items": { "type": "string", "enum": [ "", "1000000001", "2000000001", "3000000000", "5000000000", "7000000000", "8000000002", "9000000002", "10000000000", "14000000000", "15000000001", "17000000002", "20000000001", "21000000000", "23000000000", "24000000000", "26000000001", "28000000001", "29000000001" ], "enumTitles": [ "๐ŸŒ All Industries", "๐Ÿ’ฐ Financial Services", "๐Ÿฅ Health", "๐Ÿ“ฐ News & Entertainment", "๐Ÿš— Vehicle & Transportation", "๐ŸŽฎ Games", "โšฝ Sports & Outdoor", "๐Ÿ’ป Tech & Electronics", "๐Ÿ” Food & Beverage", "๐Ÿ›Ž๏ธ Life Services", "๐Ÿ“š Education", "โœˆ๏ธ Travel", "๐Ÿ’„ Beauty & Personal Care", "๐Ÿ  Home Improvement", "๐Ÿ‘ถ Baby, Kids & Maternity", "๐Ÿ‘— Apparel & Accessories", "๐Ÿ’ผ Business Services", "๐Ÿงด Household Products", "๐Ÿพ Pets" ] } }, "rankingPeriodDays": { "title": "๐Ÿ“… Ranking Period", "enum": [ "7", "30", "120" ], "type": "string", "description": "โณ Time window for the Top 100 ranking. Used by ๐Ÿ† Top 100 and ๐Ÿ“Š Top 100 + Analytics. Also accepts the base's legacy `top100_period` key." }, "analyticsPeriodDays": { "title": "๐Ÿ“ˆ Analytics Period", "enum": [ "7", "30", "120", "365", "1095" ], "type": "string", "description": "๐Ÿ”ญ Time window for per-hashtag analytics (trend curve). Used by ๐Ÿ”ฌ Hashtag Analytics and ๐Ÿ“Š Top 100 + Analytics. Also accepts the base's legacy `analytics_period` key." }, "onlyNewEntrants": { "title": "๐Ÿ†• Only New-On-Board (request-time)", "type": "boolean", "description": "โœจ Server-side filter: return only hashtags that newly entered the Top 100 in the chosen period, for EVERY selected country/industry combo. Also accepts the base's legacy `top100_new_on_board` key. (Different from the client-side '๐Ÿ†• Only Rising Rank Diff = New' filter below.)", "default": false }, "hashtagsToAnalyze": { "title": "#๏ธโƒฃ Hashtags To Analyze", "uniqueItems": true, "type": "array", "description": "๐Ÿ“ Add your own hashtags (without the `#`) to fetch analytics for, per selected market. Only used when Result Type = ๐Ÿ”ฌ Hashtag Analytics. Also accepts the base's legacy `hashtag_list`/`hashtags` keys.", "items": { "type": "string" } }, "hashtagsPerMarket": { "title": "๐Ÿ”ข Hashtags Per Market", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many hashtags to collect PER country/industry combination (not a grand total โ€” e.g. 2 countries x 2 industries x 20 = up to 80 rows). Also accepts the base's legacy `total_hashtags` key (default 100 when omitted entirely, matching the base)." }, "minVideoViews": { "title": "๐Ÿ‘๏ธ Minimum Video Views", "minimum": 0, "type": "integer", "description": "Drop any hashtag whose total video views are below this threshold. 0 = no filter." }, "minPublishCount": { "title": "๐Ÿ“ Minimum Publish Count", "minimum": 0, "type": "integer", "description": "Drop any hashtag whose publish count is below this threshold. 0 = no filter." }, "onlyRising": { "title": "๐Ÿ“ˆ Only Rising Rank", "type": "boolean", "description": "Keep only hashtags whose rank moved UP since last period (derived from `rank_diff_type`). Combine with the filters below (OR logic) or use alone.", "default": false }, "onlyFalling": { "title": "๐Ÿ“‰ Only Falling Rank", "type": "boolean", "description": "Keep only hashtags whose rank moved DOWN since last period (derived from `rank_diff_type`).", "default": false }, "onlyNew": { "title": "๐Ÿ†• Only New Rank Entries", "type": "boolean", "description": "Keep only hashtags flagged as newly-ranked in the returned batch (derived from `rank_diff_type`, client-side โ€” distinct from the request-time 'Only New-On-Board' toggle above).", "default": false }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy Configuration", "type": "object", "description": "๐Ÿ›ฐ๏ธ Choose which proxies to use. By default, no proxy is used; the actor falls back to a direct connection automatically if a proxied attempt returns no data." } } }, "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 } } } } } } } } } }