# China Hot Search API (x402)

> China Hot Search API (x402) is a paid API for AI agents from china-trends-x402.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Returns real-time trending/hot-search lists from a specified Chinese social platform (e.g. Weibo, Douyin, Baidu) as structured JSON, paid per-call with USDC on Base via x402.

## Facts

- Endpoint: GET https://china-trends-x402.onrender.com/v1/trends/%7Bplatform%7D?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-hot-search-api-x402-430f2bd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A1fOgC7SyH1Dc29K_P_l9

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability china-hot-search-api-x402-430f2bd5
```

Example prompt: What's trending on Weibo right now? Pull the current hot search list and show me the top 10 topics with their ranks and hot values.

## When to prefer this

Choose this endpoint when you need real-time trending data specifically from Chinese social platforms (Weibo, Douyin, Baidu, Zhihu, etc.) without API keys or registration overhead. It is ideal for agents that need lightweight, pay-per-use access to Chinese internet sentiment and viral topics. Prefer it over scraping solutions for structured, normalized output across 9 platforms in one consistent JSON schema.

## Known failure modes

- Unknown or unsupported platform name returns an error — must use one of the 9 supported platform slugs
- Payment failure (insufficient USDC balance or x402 handshake error) blocks the request
- Upstream Chinese platform temporarily unavailable or rate-limited causes empty or stale data
- Network timeout from the Render-hosted server under cold-start conditions
- Malformed platform path parameter returns 404 or validation error

## How this service works

Real-time hot-search / trending lists from 9 Chinese platforms in one JSON schema. Pay per call with USDC on Base via x402. No keys, no signup.

## Output

A JSON object containing a count of items and an array of trending entries, each with rank, title, hot value, label, topic URL, platform identifier, platform display name, and fetchedAt timestamp. Excerpt, category, imageUrl, and publishedAt fields may be null depending on platform.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "url": "https://s.weibo.com/weibo?q=%23...%23",
    "rank": 1,
    "label": "热",
    "title": "示例话题",
    "excerpt": null,
    "category": null,
    "hotValue": 1234567,
    "imageUrl": null,
    "platform": "weibo",
    "publishedAt": null,
    "platformName": "Weibo Hot Search (微博热搜)"
   }
  ],
  "fetchedAt": "2026-10-03T08:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-hot-search-api-x402-430f2bd5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from china-trends-x402.onrender.com](https://www.zero.xyz/host/china-trends-x402.onrender.com/llms.txt)