API DOCUMENTATION
接口文档
统一 base：https://gongliaoji.cn/api/open · GET / POST 均可 · 返回 UTF-8 JSON
| 接口 | 参数 | 说明 |
/price.aspx |
key 必填 · kw 必填（材料名关键词）
city 可选（6 位城市码，如广州 440100，可用 /city.aspx 查询） · period 可选（期次ID）
page 默认1 · size 默认20（最大100） |
材料信息价查询，返回 total 与 rows[]，含 itemCode / itemName / spec / unit / price / priceTax / priceType / periodNo / cityCode 等字段。 |
/city.aspx |
key 必填 |
城市列表，含 cityCode / cityName / provinceCode / hasData（是否有数据）。 |
/period.aspx |
key 必填 · city 可选（6 位城市码） |
期次列表，含 periodId / periodNo / year / month / title，按年期倒序。 |
调用示例
# 1) curl
curl "https://gongliaoji.cn/api/open/price.aspx?key=SK-xxxxxxxxxxxxxxxxxxxxx&kw=%E9%92%A2%E7%AD%8B&city=440100&size=5"
# 2) Python
import requests
r = requests.get("https://gongliaoji.cn/api/open/price.aspx",
params={"key": "SK-xxxxxxxxxxxxxxxxxxxxx", "kw": "钢筋", "city": "440100", "size": 20})
data = r.json()
for row in data["rows"]:
print(row["itemName"], row["spec"], row["price"], row["unit"], row["periodNo"])
# 3) JavaScript（浏览器 / Node 均可，已开放 CORS）
fetch("https://gongliaoji.cn/api/open/price.aspx?key=SK-xxx&kw=C30混凝土&city=440100")
.then(r => r.json())
.then(d => console.log(d.total, d.rows));
# 4) Excel / WPS：数据 → 自网站（Power Query），或用 VBA 的 XMLHTTP 请求同一 URL
返回示例
{
"ok": true, "code": "OK", "message": "ok",
"total": 128, "page": 1, "size": 20,
"quota": { "limit": 500, "used": 12 },
"rows": [
{
"itemCode": "010101301", "itemName": "热轧光圆钢筋",
"spec": "HPB300 φ10以内", "unit": "t",
"price": "3820.00", "priceTax": "4163.80",
"priceType": "税前综合价", "periodNo": "2026-08",
"year": 2026, "month": 8, "cityCode": "440100", "cityName": "广州"
}
]
}
错误码
| code | 含义与处理 |
|---|
NO_KEY | 未传 key 参数，请在 URL 或表单里带上 APIKEY。 |
NO_KEYWORD | 未传 kw 关键词。 |
NO_KEY / INVALID | key 无效或不是开放接口密钥，请到「我的 API 密钥」核对。 |
DISABLED | 密钥已停用，联系客服处理。 |
EXPIRED | 已过期，重新购买或续费后换用新 key。 |
OVER_QUOTA | 当日调用量已超配额，升级套餐或次日 00:00 后重试。 |
SERVER_ERROR | 服务端异常，稍后重试并保留请求参数便于排查。 |
数据多久更新一次？
各地信息价期刊发布后即入库，一般每月更新；接口始终查询最新已发布期次，无需改代码。
配额怎么算？
按自然日累计：每成功/失败一次请求计 1 次（返回 quota.limit 与 quota.used 实时可见），每日 00:00 清零。
可以商用吗？
购买套餐后可用于企业内部系统、造价软件与项目成本库，请勿对外转售或做公开镜像分发。
支持哪些城市？
已覆盖全国大部分省市（见首页统计与 /city.aspx 的 hasData 标记），具体以接口返回为准。
需要发票或合同？
企业版可开具发票并签署服务合同，购买后在订单备注或联系客服说明即可。
