# China City Lookup API

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

Look up detailed information about Chinese cities including name, province, tier classification, coordinates, and population

## Facts

- Endpoint: GET https://api.cn402.com/geo/cn/city
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-cn402-com-8914db84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r8SGqzdxnSUl5n0VIntss

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-8914db84
```

Example prompt: Can you look up the details for Chengdu in China — I need its province, city tier (like first-tier or second-tier), coordinates, and population?

## When to prefer this

Use this endpoint when you need structured data about Chinese cities, especially tier classification (一线/二线/三线), province mapping, or coordinates. Prefer this over general geocoding APIs when you specifically need China city tier data or Chinese administrative geography context.

## Known failure modes

- City name not found or unrecognized — returns 404 or empty result
- Ambiguous city name matching multiple cities — may return unexpected result
- Non-Chinese city input — not supported, returns error
- Payment not included or insufficient — returns 402 Payment Required

## How this service works

China city lookup, 中国城市查询, Chinese cities database, China city tier, 一线二线三线城市, China prefecture-level city, China city province, China city coordinates, Chinese city info. Look up China city information (name, province, tier, coordinates, population).

## Output

Returns structured information about the queried Chinese city including its official name (in Chinese and/or pinyin), the province it belongs to, its tier classification (e.g. first-tier, new first-tier, second-tier, third-tier), geographic coordinates (latitude/longitude), and population data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "ENS name e.g. vitalik.eth (required)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-cn402-com-8914db84/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)