{ "openapi": "3.0.1", "info": { "title": "Tiktok Trending Hashtags Analytics Scraper", "description": "TikTok Trending Hashtags Analytics Scraper — Analyze trending TikTok hashtags, including views, video counts, growth trends, related hashtags, and popularity metrics. Useful for trend research, content planning, hashtag strategy, influencer marketing, and competitor analysis.", "version": "0.2", "x-build-id": "FZjK7XfT31xte4NLw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~tiktok-trending-hashtags-analytics-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-tiktok-trending-hashtags-analytics-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/socialdataapi~tiktok-trending-hashtags-analytics-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-tiktok-trending-hashtags-analytics-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/socialdataapi~tiktok-trending-hashtags-analytics-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-tiktok-trending-hashtags-analytics-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": "top100 = board ranking only (analytics is an empty object). top100_with_analytics = ranking plus analytics: popularity curve, industry IDs, top creators and, under analytics.info, the hashtag's description, promoted flag, all-time posts and views and its top videos. analytics = the same analytics for every hashtag on the board, or only for the names in the custom hashtag list.", "default": "top100_with_analytics" }, "country": { "title": "📍 Country / region", "enum": [ "ALL", "AL", "AR", "AT", "AU", "BD", "BE", "BG", "BH", "BR", "BY", "CA", "CH", "CL", "CN", "CO", "CZ", "DE", "DK", "EE", "EG", "ES", "FI", "FR", "GB", "GR", "HK", "HR", "HU", "ID", "IE", "IL", "IN", "IQ", "IS", "IT", "JO", "JP", "KH", "KR", "KW", "KZ", "LB", "LT", "LU", "LV", "MA", "MN", "MO", "MX", "MY", "NG", "NL", "NO", "NZ", "OM", "PE", "PH", "PK", "PL", "PT", "QA", "RO", "SA", "SE", "SG", "SK", "TH", "TR", "TW", "UA", "AE", "US", "UZ", "VN", "ZA" ], "type": "string", "description": "TikTok publishes a trending board for 27 countries: US FR DE IT ES GB AR AU BR CA CO EG ID IL JP KR MY MX PH SA SG ZA TW TH TR AE VN. Every other value in this list, including ALL, is accepted and gets the US board; those rows say countrySupported=false and countryFallbackApplied=true.", "default": "US" }, "top100_period": { "title": "📅 Board window (days)", "enum": [ "7", "30", "90", "120" ], "type": "string", "description": "TikTok serves three windows: 7, 30 and 90 days. 120 is kept for older inputs and gets the 90-day board; those rows say periodUsed=90 and periodAliasApplied=true. The popularity curve covers this window.", "default": "7" }, "analytics_period": { "title": "📅 Analytics period (days), no effect", "enum": [ "7", "30", "120", "365", "1095" ], "type": "string", "description": "Kept for older inputs only. The popularity curve always covers the board window above, so this value changes nothing. Every row reports analyticsPeriodRequested and analyticsPeriodSupported=false.", "default": "30" }, "top100_industry": { "title": "🎯 Industry", "enum": [ "", "Apparel & Accessories", "Baby, Kids & Maternity", "Beauty & Personal Care", "Business Services", "Education", "Financial Services", "Food & Beverage", "Games", "Healthcare", "Home Improvement", "Household Products", "Life Services", "News & Entertainment", "Pets", "Real Estate", "Software & Apps", "Sports & Outdoor", "Tech & Electronics", "Travel", "Vehicle & Transportation" ], "type": "string", "description": "Leave empty for the full board: the overall ranking plus every industry's top hashtags. Pick an industry to get only that industry's trending hashtags (TikTok shows about 3 per industry without a login). Real Estate has no TikTok ranking: it returns the full board and the rows say industryFilterSupported=false.", "default": "" }, "top100_new_on_board": { "title": "✅ New to the board only, no effect", "type": "boolean", "description": "Kept for older inputs only. TikTok returns the same hashtags with and without this option and marks no hashtag as new on the board. Every row reports newOnBoardSupported=false.", "default": false }, "hashtag_list": { "title": "🔎 Custom hashtag list (analytics mode)", "type": "array", "description": "Hashtag names without the # sign. Used only when the result type is analytics: only these hashtags are returned, if they are on the selected board today. Names that are not on the board are skipped with a warning and no row is invented for them. Leave empty to get the whole board.", "default": [], "items": { "type": "string" } }, "total_hashtags": { "title": "🔢 Max hashtags to return", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of hashtag rows to save. The board holds about 55 hashtags per country and window (the overall ranking plus each industry's top hashtags), fewer when you pick an industry. Free plan: up to 20 hashtags per run and 200 per month; paid plans have no limit.", "default": 10 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Apify Proxy (residential is used when no group is chosen) or your own proxy URLs. With the proxy turned off, Apify residential proxy is added automatically when your account has it.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }