# China Province Lookup API

> China Province Lookup API is a paid API for AI agents from api.cn402.com, paid per call via x402, $0.016/call, status unknown (last checked 2026-09-14).

Look up detailed information about Chinese provinces (name, capital, area, population, region) by province name or code

## Facts

- Endpoint: GET https://api.cn402.com/geo/cn/province
- Price: $0.016/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-b45351be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zBQrRZBtEFiUYMdsynC7s

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 api-cn402-com-b45351be
```

Example prompt: Can you look up the province details for Sichuan — I need the capital, population, area, and which region it belongs to?

## When to prefer this

Use this endpoint when you need structured geographic or demographic data about Chinese provinces, such as capital cities, area, population, or regional classification. Ideal for enriching datasets with China administrative info, building China-focused geographic features, or answering user questions about specific provinces. Prefer over a general web search when structured, reliable, machine-readable province data is needed.

## Known failure modes

- Province name or code not recognized — returns error or empty result
- Ambiguous province name input causing incorrect match
- Non-mainland China regions (e.g. Hong Kong, Macau, Taiwan) may not be included
- Network or payment (x402) authorization failure returns HTTP 402 or 5xx
- Incorrect encoding of Chinese characters in input causing lookup failure

## How this service works

China province lookup, 中国省份查询, Chinese provinces database, mainland China provinces, 34省级行政区, China admin divisions, China province capital, China province area population, Chinese province codes. Look up China province information (name, capital, area, population, region) by name or code.

## Output

Returns structured data about the queried Chinese province including its official name (Chinese and/or English), capital city, land area, population, geographic region, and province code covering all 34 provincial-level administrative divisions of mainland China.

## Example request

```json
{
 "province": "Sichuan"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "format": {
   "type": "string",
   "description": "Optional response format hint"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-b45351be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.cn402.com](https://www.zero.xyz/host/api.cn402.com/llms.txt)