{"uid":"cap_zBQrRZBtEFiUYMdsynC7s","slug":"api-cn402-com-b45351be","name":"China Province Lookup API","description":"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.","url":"https://api.cn402.com/geo/cn/province","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"format":{"type":"string","description":"Optional response format hint"}}},"responseSchema":null,"example":{"request":{"province":"Sichuan"},"response":{"meta":{"source":"Built-in dataset","standard":"GB/T 2260"},"_hint":"x402 paid endpoints for AI agents — x402node.dev (utilities) · cn402.com (Chinese culture)","count":34,"provinces":[{"code":"110000","name":"北京市","type":"municipality","short":"京","pinyin":"Beijing","capital":"北京"},{"code":"120000","name":"天津市","type":"municipality","short":"津","pinyin":"Tianjin","capital":"天津"},{"code":"130000","name":"河北省","type":"province","short":"冀","pinyin":"Hebei","capital":"石家庄"},{"code":"140000","name":"山西省","type":"province","short":"晋","pinyin":"Shanxi","capital":"太原"},{"code":"150000","name":"内蒙古自治区","type":"autonomous_region","short":"蒙","pinyin":"Neimenggu","capital":"呼和浩特"},{"code":"210000","name":"辽宁省","type":"province","short":"辽","pinyin":"Liaoning","capital":"沈阳"},{"code":"220000","name":"吉林省","type":"province","short":"吉","pinyin":"Jilin","capital":"长春"},{"code":"230000","name":"黑龙江省","type":"province","short":"黑","pinyin":"Heilongjiang","capital":"哈尔滨"},{"code":"310000","name":"上海市","type":"municipality","short":"沪","pinyin":"Shanghai","capital":"上海"},{"code":"320000","name":"江苏省","type":"province","short":"苏","pinyin":"Jiangsu","capital":"南京"},{"code":"330000","name":"浙江省","type":"province","short":"浙","pinyin":"Zhejiang","capital":"杭州"},{"code":"340000","name":"安徽省","type":"province","short":"皖","pinyin":"Anhui","capital":"合肥"},{"code":"350000","name":"福建省","type":"province","short":"闽","pinyin":"Fujian","capital":"福州"},{"code":"360000","name":"江西省","type":"province","short":"赣","pinyin":"Jiangxi","capital":"南昌"},{"code":"370000","name":"山东省","type":"province","short":"鲁","pinyin":"Shandong","capital":"济南"},{"code":"410000","name":"河南省","type":"province","short":"豫","pinyin":"Henan","capital":"郑州"},{"code":"420000","name":"湖北省","type":"province","short":"鄂","pinyin":"Hubei","capital":"武汉"},{"code":"430000","name":"湖南省","type":"province","short":"湘","pinyin":"Hunan","capital":"长沙"},{"code":"440000","name":"广东省","type":"province","short":"粤","pinyin":"Guangdong","capital":"广州"},{"code":"450000","name":"广西壮族自治区","type":"autonomous_region","short":"桂","pinyin":"Guangxi","capital":"南宁"},{"code":"460000","name":"海南省","type":"province","short":"琼","pinyin":"Hainan","capital":"海口"},{"code":"500000","name":"重庆市","type":"municipality","short":"渝","pinyin":"Chongqing","capital":"重庆"},{"code":"510000","name":"四川省","type":"province","short":"川","pinyin":"Sichuan","capital":"成都"},{"code":"520000","name":"贵州省","type":"province","short":"黔","pinyin":"Guizhou","capital":"贵阳"},{"code":"530000","name":"云南省","type":"province","short":"滇","pinyin":"Yunnan","capital":"昆明"},{"code":"540000","name":"西藏自治区","type":"autonomous_region","short":"藏","pinyin":"Xizang","capital":"拉萨"},{"code":"610000","name":"陕西省","type":"province","short":"陕","pinyin":"Shaanxi","capital":"西安"},{"code":"620000","name":"甘肃省","type":"province","short":"甘","pinyin":"Gansu","capital":"兰州"},{"code":"630000","name":"青海省","type":"province","short":"青","pinyin":"Qinghai","capital":"西宁"},{"code":"640000","name":"宁夏回族自治区","type":"autonomous_region","short":"宁","pinyin":"Ningxia","capital":"银川"},{"code":"650000","name":"新疆维吾尔自治区","type":"autonomous_region","short":"新","pinyin":"Xinjiang","capital":"乌鲁木齐"},{"code":"710000","name":"台湾省","type":"province","short":"台","pinyin":"Taiwan","capital":"台北"},{"en":"Hong Kong","code":"810000","name":"香港特别行政区","type":"sar","short":"港","pinyin":"Xianggang","capital":"香港"},{"en":"Macau","code":"820000","name":"澳门特别行政区","type":"sar","short":"澳","pinyin":"Aomen","capital":"澳门"}]}},"exampleRequest":{"province":"Sichuan"},"tags":["x402"],"displayCostAmount":"0.016","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.016/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.016","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.016","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Mj4_EZvaLQUiuq8pLsysv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.016","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up detailed information about Chinese provinces (name, capital, area, population, region) by province name or code","exampleAgentPrompt":"Can you look up the province details for Sichuan — I need the capital, population, area, and which region it belongs to?","exampleUseCases":[{"title":"Find Chinese province capital city","prompt":"What's the capital city of Guangdong province? I'm putting together a travel itinerary and need to know where to fly into."},{"title":"Get province population and area","prompt":"I'm building a market sizing report for mainland China — can you pull up the population and land area for Zhejiang province?"},{"title":"Look up province by code","prompt":"I have the province code 310000 in my dataset but I'm not sure which province that maps to — can you look it up and tell me the name, region, and capital?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:40:39.392Z","isFirstParty":false}