{
  "openapi": "3.0.1",
  "info": {
    "title": "China Trend Tracker: Weibo, Douyin, Baidu Hot List Alerts",
    "description": "Track China's hot lists on a schedule and get only what changed: new topics on Weibo, Douyin, Baidu, Zhihu, Toutiao and 16 more boards, topics that spread to another board, climb into the top 10 or drop off, each with first seen, hours on list and best rank. Watch keywords for brand alerts.",
    "version": "0.1",
    "x-build-id": "8jie5tnNpVBrwbWdd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~china-hot-lists/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-china-hot-lists",
        "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~china-hot-lists/runs": {
      "post": {
        "operationId": "runs-sync-memo23-china-hot-lists",
        "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~china-hot-lists/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-china-hot-lists",
        "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": {
          "boards": {
            "title": "Boards",
            "type": "array",
            "description": "Hot lists to read. Empty = Weibo, Douyin, Kuaishou, Baidu, Toutiao, Zhihu, Bilibili hot search and Tieba.",
            "items": {
              "type": "string",
              "enum": [
                "weibo",
                "douyin",
                "kuaishou",
                "baidu",
                "baidu_novel",
                "baidu_movie",
                "baidu_teleplay",
                "baidu_car",
                "baidu_game",
                "toutiao",
                "zhihu",
                "bilibili",
                "bilibili_rank",
                "tieba",
                "thepaper",
                "kr36",
                "tencent",
                "netease",
                "sina",
                "juejin",
                "douban_movie"
              ],
              "enumTitles": [
                "Weibo hot search 微博热搜",
                "Douyin hot list 抖音热榜",
                "Kuaishou hot list 快手热榜",
                "Baidu hot search 百度热搜",
                "Baidu novels 小说榜",
                "Baidu movies 电影榜",
                "Baidu TV series 电视剧榜",
                "Baidu cars 汽车榜",
                "Baidu games 游戏榜",
                "Toutiao hot board 头条热榜",
                "Zhihu hot list 知乎热榜",
                "Bilibili hot search B站热搜",
                "Bilibili video ranking B站排行榜",
                "Baidu Tieba hot topics 贴吧热议",
                "The Paper 澎湃热榜",
                "36Kr hot articles 36氪热榜",
                "Tencent News 腾讯新闻热点榜",
                "NetEase News 网易热点",
                "Sina hot search 新浪热榜",
                "Juejin tech articles 掘金热榜",
                "Douban movies now 豆瓣热门电影"
              ]
            }
          },
          "watchKeywords": {
            "title": "Watch keywords",
            "type": "array",
            "description": "Return only topics whose title contains one of these words, for example a brand, a person or a product. Chinese (特斯拉, 瑞幸) or English (Tesla, iPhone); English words are matched on the English titles. Empty = every topic.",
            "items": {
              "type": "string"
            }
          },
          "output": {
            "title": "Return",
            "enum": [
              "changes",
              "all"
            ],
            "type": "string",
            "description": "Changes: new topics, topics that came back, reached another board, entered the top ranks or left the lists. The first run of a tracker returns every topic as new.",
            "default": "changes"
          },
          "topRank": {
            "title": "Top ranks",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "A topic that climbs to this rank or higher on a board is reported as entered_top.",
            "default": 10
          },
          "translateTitles": {
            "title": "English titles",
            "type": "boolean",
            "description": "Add an English machine translation of each title in titleEn.",
            "default": false
          },
          "trackerName": {
            "title": "Tracker name",
            "type": "string",
            "description": "Each name keeps its own topic history, so several schedules can track different boards or keywords, for example brand-watch and all-boards-hourly.",
            "default": "default"
          },
          "forgetAfterHours": {
            "title": "Forget topics after (hours)",
            "minimum": 1,
            "maximum": 720,
            "type": "integer",
            "description": "A topic not seen on any list for this long is dropped from the history; if it trends again later it is new again.",
            "default": 72
          },
          "maxItemsPerBoard": {
            "title": "Max topics per board",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Each board lists 10-50 topics (Bilibili's ranking up to 100).",
            "default": 50
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Cap on rows in the run. Free-plan runs return up to 100; rows past the cap come in the next run.",
            "default": 10000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}