{ "openapi": "3.0.1", "info": { "title": "Douyin Trends 抖音热点榜 [From $2] Hot Videos, Topics, Searches", "description": "[From $2 per 1000 rows] Douyin (抖音) trend rankings: hot videos, low-follower hits, high like-rate videos, hot and rising topics and search terms, hot words, fastest-growing accounts and hot events by city. 1 hour to 7 days, 38 categories, trend history per row. No login.", "version": "0.1", "x-build-id": "yk1WdGc9UogvfW5V5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~douyin-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-douyin-trends-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/memo23~douyin-trends-scraper/runs": { "post": { "operationId": "runs-sync-memo23-douyin-trends-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/memo23~douyin-trends-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-douyin-trends-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": { "lists": { "title": "Lists", "uniqueItems": true, "type": "array", "description": "Which rankings to return. Each list is fetched on its own; every row says which list it came from.", "items": { "type": "string", "enum": [ "hotVideos", "lowFollowerHits", "highCompletion", "highFollowGrowth", "highLikeRate", "hotTopics", "risingTopics", "hotSearches", "risingSearches", "hotWords", "hotAccounts", "risingEvents", "challenges", "cityEvents" ], "enumTitles": [ "Hot videos (视频总榜)", "Low-follower hits (低粉爆款)", "High completion rate (高完播率)", "High follower growth (高涨粉率)", "High like rate (高点赞率)", "Hot topics (话题榜)", "Rising topics (热度飙升话题)", "Hot searches (搜索榜)", "Rising searches (热度飙升搜索)", "Hot content words (内容热词)", "Hot accounts (热门账号)", "Rising hot events (上升热点)", "Hot challenges (挑战榜)", "City hot events (同城热点)" ] } }, "timeWindow": { "title": "Time window", "enum": [ "1h", "24h", "3d", "7d" ], "type": "string", "description": "Period the video, topic, search, word and account lists cover. Hot accounts have no 1-hour list and use 24 hours instead. Hot events are always live.", "default": "24h" }, "category": { "title": "Content category", "enum": [ "", "628", "629", "634", "624", "612", "626", "610", "632", "631", "607", "604", "613", "633", "614", "605", "615", "635", "606", "621", "602", "619", "611", "627", "641", "623", "638", "616", "622", "625", "603", "617", "636", "601", "618", "642", "620", "643", "608" ], "type": "string", "description": "Limit the video, topic and account lists to one content category.", "default": "" }, "eventCategory": { "title": "Hot-event category", "enum": [ "", "food", "travel", "platform", "topics", "entertainment", "society", "anime", "transport", "parenting", "sports", "military", "drama", "pets", "weather", "talent", "education", "fashion", "politics", "campus", "cars", "gaming", "technology", "finance" ], "type": "string", "description": "Limit the rising hot events and city hot events lists to one category.", "default": "" }, "keyword": { "title": "Keyword filter", "type": "string", "description": "Keep only entries matching this keyword. Works on every list except hot accounts." }, "cityCode": { "title": "City code", "type": "string", "description": "For 'City hot events': a Chinese administrative code, for example `110000` Beijing, `310000` Shanghai, `440100` Guangzhou, `440300` Shenzhen. Empty returns all cities." }, "maxItemsPerList": { "title": "Max rows per list", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper bound on rows per list. Lists hold up to about 1,000 entries. Free-plan runs return up to 50 per list.", "default": 50 }, "includeHotWordDetails": { "title": "Hot word details", "type": "boolean", "description": "For each row of the 'Hot content words' list, add 7-day totals (videos, plays, likes, comments, shares) and up to 20 sample video links. Billed as `hot-word-detail` on top of the row.", "default": false }, "videos": { "title": "Videos", "type": "array", "description": "Douyin video links or ids. Each returns one `video-analytics` row: the audience of the people who liked it (gender, age, province, city, city tier, phone brand and price, each with an index against the platform average), the comment word cloud and daily likes, shares and comments. Works for videos big enough to have statistics.", "items": { "type": "string" } }, "accounts": { "title": "Accounts", "type": "array", "description": "Douyin profile links (`https://www.douyin.com/user/MS4w…`). Each returns one `account-analytics` row: follower audience with interests, daily new likes, videos, comments and shares, and last week's averages against the week before.", "items": { "type": "string" } }, "accountKeywords": { "title": "Account search keywords", "type": "array", "description": "Find accounts by name or Douyin handle. Each result is an `account` row with followers, total likes, video count and the profile link. Billed as `account-search-result`.", "items": { "type": "string" } }, "maxAccountsPerKeyword": { "title": "Max accounts per keyword", "minimum": 1, "maximum": 300, "type": "integer", "description": "Upper bound on accounts per account-search keyword.", "default": 30 }, "includeCalendar": { "title": "Activity calendar", "type": "boolean", "description": "Douyin's planned activities and campaign topics for the coming days, nationwide, as `calendar-event` rows.", "default": false }, "calendarDays": { "title": "Calendar days ahead", "minimum": 1, "maximum": 90, "type": "integer", "description": "How far ahead the activity calendar looks.", "default": 14 } } }, "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 } } } } } } } } } }