# 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.01/call, status unknown (last checked 2026-10-12).

Returns real-time trending/hot-search entries from 9 major Chinese social and news platforms filtered by keyword, paid per call with USDC via x402.

## Facts

- Endpoint: GET https://china-trends-x402.onrender.com/v1/check?utm_source=zero.xyz
- Price: $0.01/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-add0c997
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7O68Qj3YAgd9IecSidOfw

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

Example prompt: Check what's trending right now on Chinese platforms about '华为' — pull hot search results across all 9 platforms and show me the titles, 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, etc.) for one or more keywords simultaneously, without managing API keys or platform-specific authentication. It is ideal for brand monitoring, journalism, competitive intelligence, and market research focused on the Chinese internet. Prefer it over scraping individual platforms or using general web search when you need structured, ranked hot-search data from multiple Chinese sources in a single call and are comfortable with micropayment-per-call pricing via USDC on Base.

## Known failure modes

- Keyword not found trending on any platform returns an empty hits array with hitCount 0 and trending false
- Invalid or missing 'q' query parameter returns a 400-level error
- Platform-side outages may cause partial results with errors object populated for affected platforms
- More than 10 comma-separated keywords may be rejected or silently truncated
- Service downtime on the Render host returns a 502/503 with no JSON body
- x402 payment failure or insufficient USDC balance blocks the request before any data is returned

## 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 list of results per keyword with matched trending hits (each with title, platform, rank, hotValue, and URL), a hit count, a trending boolean, the timestamp the data was fetched, and the number of platforms checked (up to 9). Errors per keyword are also included if any platform fetch failed.

## 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",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword, or up to 10 comma-separated keywords. Case-insensitive substring match on titles."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "errors": {},
  "results": [
   {
    "hits": [
     {
      "url": "https://s.weibo.com/weibo?q=%23...%23",
      "rank": 3,
      "title": "华为发布会",
      "hotValue": 1234567,
      "platform": "weibo"
     }
    ],
    "keyword": "华为",
    "hitCount": 1,
    "trending": true
   }
  ],
  "fetchedAt": "2026-10-03T08:00:00Z",
  "platformsChecked": 9
 }
}
```

## More

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