TopHub APItophub.today ↗
Retrieve ~100 aggregated hot search rankings from tophub.today across Weibo, Zhihu, Bilibili, Hupu, and Douyin in a single API call.
What is the TopHub API?
The tophub.today API exposes a single endpoint, get_hot_list, that returns approximately 100 aggregated trending items pulled from major Chinese social platforms including Weibo, Zhihu, Bilibili, Hupu, and Douyin. Each item carries a title, description, source site, source domain, hot value score, thumbnail, and a direct URL — giving developers a unified cross-platform trending feed without calling each platform separately.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5a2bd56a-a6c2-4bba-83d6-72456543feac/get_hot_list' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tophub-today-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: TopHub Today API — fetch trending topics across Chinese platforms."""
from parse_apis.tophub_today_api import TopHub, ParseError
client = TopHub()
# List the top 10 trending topics across all platforms
try:
for topic in client.topics.list(limit=10):
print(f"{topic.source_site}: {topic.title} ({topic.hot_value})")
except ParseError as e:
print(f"Failed to fetch topics: {e.code}")
raise
# Drill into the first topic for full details
top_topic = client.topics.list(limit=1).first()
if top_topic is not None:
print(f"\nTop topic: {top_topic.title}")
print(f" Source: {top_topic.source_site} ({top_topic.source_domain})")
print(f" URL: {top_topic.url}")
print(f" Hot value: {top_topic.hot_value}")
print(f" Description: {top_topic.description[:120]}")
print("\nexercised: topics.list")
Returns the full aggregated hot search ranking list from tophub.today. This combines trending topics across all major Chinese platforms (Zhihu, Weibo, Hupu, Douyin, etc.) ranked by composite hot value. Returns approximately 100 items sorted by popularity. No pagination needed as the full list is returned in a single call.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of hot ranking items, each containing id, title, description, url, thumbnail, hot_value, extra, source_site, source_domain, source_logo, and timestamp",
"total": "integer count of items returned"
},
"sample": {
"data": {
"items": [
{
"id": 246013438,
"url": "https://www.zhihu.com/question/2071625579925869050",
"extra": "2188 万热度",
"title": "旺旺董事长发内部信，直言遭遇重大经营危机，没有贡献的员工要被淘汰，这种方式能救企业吗？",
"hot_value": "1493万热度",
"thumbnail": "https://picx.zhimg.com/v2-29e0a6a5fbe435d93157d038e8b69c1c.png",
"timestamp": 1786750209,
"description": "据蓝鲸新闻报道，2026 年 8 月初，旺旺集团董事长蔡衍明发布致全体旺旺人的公开信...",
"source_logo": "https://file.ipadown.com/tophub/assets/images/media/zhihu.com.png_50x50.png",
"source_site": "知乎",
"source_domain": "zhihu.com"
}
],
"total": 100
},
"status": "success"
}
}About the TopHub API
What get_hot_list Returns
The get_hot_list endpoint takes no input parameters and returns a flat array of trending items under the items field, plus a total integer confirming the count. Each item in the array includes: id (unique item identifier), title (the trending topic or headline), description (supporting context or subtitle), url (link to the original content), thumbnail (preview image URL), hot_value (composite popularity score used for ranking), extra (platform-specific supplemental data), source_site (human-readable platform name, e.g. "Weibo" or "Zhihu"), and source_domain (the domain the item originated from).
Coverage and Ranking
Items are sorted descending by hot_value, a composite score that aggregates trending signals across all indexed platforms. The full list covers roughly 100 items at a time, mixing content from Weibo, Zhihu, Bilibili, Hupu, Douyin, and other Chinese-language platforms. Because the list is pre-sorted and complete in a single response, no pagination parameters are needed.
Filtering by Platform
The response does not include a built-in filter parameter — get_hot_list always returns the full unified ranking. If you need to segment by platform, filter the returned items array client-side using the source_site or source_domain fields. This makes it straightforward to isolate, for example, only Zhihu items or only Bilibili items from the combined feed.
The TopHub API is a managed, monitored endpoint for tophub.today — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tophub.today changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tophub.today API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor real-time viral topics on Weibo and Zhihu for brand mention tracking using the
titleandsource_sitefields. - Build a Chinese social trends dashboard ranked by
hot_valueacross Bilibili, Hupu, and Douyin. - Filter
itemsbysource_domainto feed platform-specific trending topics into content recommendation engines. - Use
thumbnailandurlfields to render a visual trending feed widget for a media or news aggregator. - Detect emerging cultural events or news stories by comparing
hot_valuesnapshots over time. - Segment Hupu sports trending topics from
source_siteto feed a sports analytics or fan engagement tool. - Seed keyword research with
titlevalues from the top-ranked items across Chinese social platforms.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does tophub.today offer an official developer API?+
What does the hot_value field represent?+
hot_value field is a composite numeric score that reflects a topic's popularity ranking on the source platform at the time of retrieval. Items in the items array are sorted descending by this value. It is platform-native — a Weibo hot value and a Zhihu hot value are not directly comparable on the same numeric scale, so treat it primarily as a sort key within the full list.Can I retrieve trending data for a single platform rather than the full aggregated list?+
get_hot_list endpoint returns the full combined ranking with no platform filter parameter. Per-platform filtering is done client-side using the source_site or source_domain fields in the response. You can fork this API on Parse and revise it to add a platform-specific endpoint if you need server-side filtering.Is historical trending data available through this API?+
get_hot_list. You can fork this API on Parse and revise it to add a history or time-series endpoint that stores and queries past snapshots.How fresh is the data returned by get_hot_list?+
hot_value changes is the recommended approach.