{ "openapi": "3.0.1", "info": { "title": "TikTok Trending Hashtags : Top Creators Scraper", "description": "Scrape the hottest TikTok hashtags with the TikTok Trending Hashtags Scraper. Extract hashtag names, rankings, related videos, usage stats, and engagement insights. Perfect for trend tracking, content planning, and market research. Fast, accurate, and scalable for any region.", "version": "0.1", "x-build-id": "9fPXfHu87RUZReEu4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~tiktok-trending-hashtags-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~tiktok-trending-hashtags-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~tiktok-trending-hashtags-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-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": { "resultMode": { "title": "🎯 Result Mode", "enum": [ "top100", "top100_with_analytics", "analytics" ], "type": "string", "description": "✨ What the scraper should return.\n\nβ€’ πŸ† Top Hashtags β€” trending list only.\nβ€’ πŸ“Š Top Hashtags + Analytics β€” trending list with per-hashtag trend curve + top creators.\nβ€’ πŸ”¬ Custom Hashtag Lookup β€” analytics for your own πŸ”  Target Hashtags list.\n\nAlias of the base actor's `result_type` (still accepted)." }, "targetCountry": { "title": "🌍 Target 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": "πŸ—ΊοΈ Country to pull the trending ranking + top creators from (🌐 All = global). Alias of the base actor's `country`." }, "trendWindowDays": { "title": "πŸ“… Trend Window", "enum": [ "7", "30", "120" ], "type": "string", "description": "⏳ Time window for the trending ranking + top creators. Alias of the base actor's `top100_period`." }, "analyticsWindowDays": { "title": "πŸ“ˆ Analytics Window", "enum": [ "7", "30", "120", "365", "1095" ], "type": "string", "description": "πŸ”­ Time window for the trend curve used in πŸ”¬ Custom Hashtag Lookup. Alias of the base actor's `analytics_period`." }, "industryFocus": { "title": "🏷️ Industry Focus", "enum": [ "", "1000000001", "2000000001", "3000000000", "5000000000", "7000000000", "8000000002", "9000000002", "10000000000", "14000000000", "15000000001", "17000000002", "20000000001", "21000000000", "23000000000", "24000000000", "26000000001", "28000000001", "29000000001" ], "type": "string", "description": "🎨 Narrow the ranking by TikTok Creative Center industry. Alias of the base actor's `top100_industry`." }, "newEntrantsOnly": { "title": "πŸ†• New Entrants Only", "type": "boolean", "description": "✨ Only return hashtags that newly entered the ranking in the chosen window. Alias of the base actor's `top100_new_on_board`." }, "targetHashtags": { "title": "#️⃣ Target Hashtags", "uniqueItems": true, "type": "array", "description": "πŸ“ Your own hashtags (without `#`) to look up β€” used when 🎯 Result Mode = πŸ”¬ Custom Hashtag Lookup. Alias of the base actor's `hashtag_list`.", "items": { "type": "string" } }, "maxHashtags": { "title": "πŸ”’ Max Hashtags", "minimum": 1, "maximum": 500, "type": "integer", "description": "πŸ“Š How many trending hashtags (and their top creators) to collect per run. Alias of the base actor's `total_hashtags`." }, "enrichCreatorProfiles": { "title": "πŸ‘€ Enrich Creator Profiles", "type": "boolean", "description": "πŸ”Ž For every top creator surfaced by a hashtag, fetch their public TikTok profile and add follower count, verified flag and bio. New feature β€” no base equivalent. Failed lookups are left `null`, never faked.", "default": true }, "maxCreatorsToEnrich": { "title": "🎬 Max Creators To Enrich", "minimum": 0, "maximum": 500, "type": "integer", "description": "πŸ›‘οΈ Safety cap on how many unique creators get a profile-enrichment fetch in one run (0 = unlimited). Creators beyond the cap still appear in the output with `enrichmentStatus: \"skipped_cap\"`.", "default": 30 }, "buildCreatorLeaderboard": { "title": "πŸ† Build Creator Leaderboard", "type": "boolean", "description": "πŸ“ˆ Add a derived `creator_leaderboard` roll-up row per unique creator that appeared across multiple hashtags in this run β€” ranked by appearance count then combined reach (sum of the video views of every hashtag they surfaced in). New feature β€” no base equivalent.", "default": true }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy Configuration", "type": "object", "description": "πŸ›°οΈ Choose which proxies to use. By default, no proxy is used." } } }, "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 } } } } } } } } } }