# China Hot Search API

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

Returns real-time trending/hot-search topics aggregated from 9 major Chinese platforms (Baidu, Douyin, Weibo, etc.) in a unified JSON response, paid per-call with USDC via x402.

## Facts

- Endpoint: GET https://china-trends-x402.onrender.com/v1/top?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-hot-search-api-c13916ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KgiteCe3FEdEHg31YQvJK

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-c13916ca
```

Example prompt: What are the top 30 trending topics across Chinese platforms like Baidu, Weibo, and Douyin right now?

## When to prefer this

Choose this endpoint when you need a single unified call to get real-time trending topics aggregated across multiple major Chinese platforms simultaneously. It is ideal over scraping individual platforms yourself or using separate APIs for each platform. Particularly suited for market research, brand monitoring, news aggregation, or any use case requiring broad Chinese internet trend coverage with minimal setup — no API keys or signups required.

## Known failure modes

- Payment failure: x402 payment not accepted or insufficient USDC balance — returns 402 Payment Required
- Invalid n parameter: value outside 1–50 range returns a validation error
- Platform fetch timeout: one or more upstream Chinese platforms may be unavailable, potentially returning partial results
- Rate limiting or rendering server cold start on Render.com may cause elevated latency or 503 errors

## 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 returned topics, a fetchedAt timestamp, and an array of topic objects each with: the topic text (in Chinese), a URL to the Weibo search for that topic, its best rank across platforms, the list of platforms it appeared on, and the number of platforms it trended on.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "n": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Number of topics (default 15)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "topics": [
   {
    "url": "https://s.weibo.com/weibo?q=%23...%23",
    "topic": "示例话题",
    "bestRank": 1,
    "platforms": [
     "baidu",
     "douyin",
     "weibo"
    ],
    "platformCount": 3
   }
  ],
  "fetchedAt": "2026-10-03T08:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-hot-search-api-c13916ca/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)