{
  "openapi": "3.0.1",
  "info": {
    "title": "China Hot Search in English — Weibo, Zhihu, Baidu & Douyin",
    "description": "Weibo hot search (微博热搜), Zhihu, Baidu, Douyin, Toutiao and Bilibili hot lists plus Chinese news, with English headlines, rank and heat. Optional Deletion Watch flags hot topics that vanish while trending.",
    "version": "0.2",
    "x-build-id": "ebtkbgvheMyvvX5cB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/china.unofficial~china-hot-search-english/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-china.unofficial-china-hot-search-english",
        "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/china.unofficial~china-hot-search-english/runs": {
      "post": {
        "operationId": "runs-sync-china.unofficial-china-hot-search-english",
        "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/china.unofficial~china-hot-search-english/run-sync": {
      "post": {
        "operationId": "run-sync-china.unofficial-china-hot-search-english",
        "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": {
          "hotLists": {
            "title": "Hot lists",
            "type": "array",
            "description": "Public trending lists, fetched logged-out. Leave a list out and it is not fetched or billed. Pick only Weibo for a Weibo-only feed.",
            "items": {
              "type": "string",
              "enum": [
                "weibo",
                "baidu",
                "zhihu",
                "toutiao",
                "bilibili",
                "douyin",
                "kuaishou"
              ],
              "enumTitles": [
                "Weibo hot search 微博热搜",
                "Baidu hot search 百度热搜",
                "Zhihu hot list 知乎热榜",
                "Toutiao hot board 今日头条",
                "Bilibili hot search 哔哩哔哩",
                "Douyin hot list 抖音 (public mirror)",
                "Kuaishou hot list 快手 (public mirror)"
              ]
            },
            "default": [
              "weibo",
              "baidu",
              "zhihu",
              "toutiao",
              "bilibili",
              "douyin",
              "kuaishou"
            ]
          },
          "sourceTypes": {
            "title": "News outlet types",
            "type": "array",
            "description": "Which news rows to include, by the type of outlet that published them. The label describes the outlet, not whether a story is true. Choose none for hot lists only.",
            "items": {
              "type": "string",
              "enum": [
                "State media",
                "Party-gov",
                "Commercial platform",
                "Overseas Chinese media",
                "Critical voices",
                "Censorship tracker"
              ],
              "enumTitles": [
                "State media 官方媒体",
                "Party and government 党政机构",
                "Commercial platforms 商业平台",
                "Overseas Chinese media 海外华文媒体",
                "Critical voices 批评声音",
                "Censorship trackers 审查追踪"
              ]
            },
            "default": [
              "State media",
              "Party-gov",
              "Commercial platform",
              "Overseas Chinese media",
              "Critical voices",
              "Censorship tracker"
            ]
          },
          "newsSources": {
            "title": "News outlets",
            "type": "array",
            "description": "\"all\" (default) = every approved outlet that can be read logged-out. Or list outlet ids, for example xinhua, mfa, bbc.",
            "items": {
              "type": "string"
            },
            "default": [
              "all"
            ]
          },
          "keywords": {
            "title": "Keywords (free filter)",
            "type": "array",
            "description": "Keep only rows whose title, summary or source contains one of these words (Chinese or English, case-insensitive). Empty keeps all.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxItems": {
            "title": "Max billed rows",
            "minimum": 1,
            "type": "integer",
            "description": "Cap on the total number of billed rows this run. The Console pre-fills 50. Left empty, the cap is 200. A run capped at 200 rows or fewer finishes in about 4 minutes with the rows it collected by then.",
            "default": 200
          },
          "maxHotRank": {
            "title": "Hot-list rows up to rank",
            "minimum": 5,
            "maximum": 50,
            "type": "integer",
            "description": "Hot-list topics ranked below this are left out. 50 keeps the whole board.",
            "default": 50
          },
          "emitOnlyNew": {
            "title": "Only rows I haven't received yet",
            "type": "boolean",
            "description": "On (default): a scheduled run returns and bills only rows that are new since your last run. Off: every run returns a full snapshot.",
            "default": true
          },
          "deletionWatch": {
            "title": "Deletion Watch (paid add-on)",
            "type": "boolean",
            "description": "Off by default. On: topics that drop off the Weibo, Baidu, Zhihu, Toutiao or Bilibili hot lists while still hot are rechecked and flagged Likely censored, with the evidence for each flag. Each flag is billed as a deletion-watch-row event on top of the row price; Returned rows have no add-on charge. See the Pricing tab.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}