全国各省今日油价数据,包含92号、95号、98号汽油和0号柴油价格。
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
23 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_3703a327786308ad17a2bffe2491de77 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 暂无业务参数 | ||||
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
success |
boolean | 请求是否成功 | |
data |
object | 油价数据 | |
cache |
boolean | 是否来自缓存(true=缓存,false=实时获取) | |
generated_at |
string | 数据生成时间 | |
data.update_date |
string | 油价更新日期(YYYY-MM-DD) | |
data.count |
integer | 省份数量 | |
data.list |
array | 各省油价列表 | |
data.list[].date |
string | 日期 | |
data.list[].province |
string | 省份名称 | |
data.list[].0h |
string | 0号柴油价格(元/升),空或0表示无数据 | |
data.list[].89h |
string | 89号汽油价格(元/升) | |
data.list[].92h |
string | 92号汽油价格(元/升) | |
data.list[].95h |
string | 95号汽油价格(元/升) | |
data.list[].98h |
string | 98号汽油价格(元/升) | |
{"success":true,"data":{"update_date":"2026-08-01","count":31,"list":[{"date":"2026-08-01","province":"山东","0h":"7.55","89h":"7.37","90h":"","92h":"7.93","93h":"","95h":"8.51","97h":"","98h":"9.51"},{"date":"2026-08-01","province":"西藏","0h":"8.17","89h":"8.34","90h":"","92h":"8.84","93h":"","95h":"9.35","97h":"","98h":"9.79"},{"date":"2026-08-01","province":"上海","0h":"7.62","89h":"7.40","90h":"","92h":"7.93","93h":"","95h":"8.44","97h":"","98h":"10.44"},{"date":"2026-08-01","province":"福建","0h":"7.63","89h":"7.38","90h":"","92h":"7.93","93h":"","95h":"8.47","97h":"","98h":"9.97"},{"date":"2026-08-01","province":"吉林","0h":"7.55","89h":"0.00","90h":"","92h":"7.93","93h":"","95h":"8.56","97h":"","98h":"9.32"},{"date":"2026-08-01","province":"山西","0h":"7.71","89h":"7.41","90h":"","92h":"7.92","93h":"","95h":"8.54","97h":"","98h":"9.72"},{"date":"2026-08-01","province":"甘肃","0h":"7.54","89h":"7.36","90h":"","92h":"7.97","93h":"","95h":"8.51","97h":"","98h":"9.08"},{"date":"2026-08-01","province":"宁夏","0h":"7.52","89h":"7.42","90h":"","92h":"7.87","93h":"","95h":"8.31","97h":"","98h":"9.48"},{"date":"2026-08-01","province":"四川","0h":"7.68","89h":"7.48","90h":"","92h":"8.06","93h":"","95h":"8.62","97h":"","98h":"9.83"},{"date":"2026-08-01","province":"河北","0h":"7.64","89h":"7.38","90h":"","92h":"7.96","93h":"","95h":"8.41","97h":"","98h":"9.23"},{"date":"2026-08-01","province":"河南","0h":"7.62","89h":"0.00","90h":"","92h":"7.98","93h":"","95h":"8.52","97h":"","98h":"9.17"},{"date":"2026-08-01","province":"浙江","0h":"7.62","89h":"7.36","90h":"","92h":"7.94","93h":"","95h":"8.44","97h":"","98h":"9.94"},{"date":"2026-08-01","province":"广西","0h":"7.69","89h":"7.47","90h":"","92h":"8.03","93h":"","95h":"8.67","97h":"","98h":"9.95"},{"date":"2026-08-01","province":"重庆","0h":"7.70","89h":"7.59","90h":"","92h":"8.03","93h":"","95h":"8.48","97h":"","98h":"10.24"},{"date":"2026-08-01","province":"湖北","0h":"7.63","89h":"0.00","90h":"","92h":"7.98","93h":"","95h":"8.54","97h":"","98h":"9.99"},{"date":"2026-08-01","province":"湖南","0h":"7.70","89h":"7.42","90h":"","92h":"7.92","93h":"","95h":"8.41","97h":"","98h":"9.61"},{"date":"2026-08-01","province":"海南","0h":"7.72","89h":"8.38","90h":"","92h":"9.08","93h":"","95h":"9.65","97h":"","98h":"10.65"},{"date":"2026-08-01","province":"江西","0h":"7.69","89h":"7.37","90h":"","92h":"7.93","93h":"","95h":"8.51","97h":"","98h":"10.01"},{"date":"2026-08-01","province":"云南","0h":"7.71","89h":"7.47","90h":"","92h":"8.12","93h":"","95h":"8.71","97h":"","98h":"9.39"},{"date":"2026-08-01","province":"黑龙江","0h":"7.43","89h":"0.00","90h":"","92h":"7.93","93h":"","95h":"8.50","97h":"","98h":"9.64"},{"date":"2026-08-01","province":"内蒙古","0h":"7.49","89h":"0.00","90h":"","92h":"7.97","93h":"","95h":"8.47","97h":"","98h":"9.25"},{"date":"2026-08-01","province":"辽宁","0h":"7.53","89h":"0.00","90h":"","92h":"8.03","93h":"","95h":"8.59","97h":"","98h":"9.41"},{"date":"2026-08-01","province":"广东","0h":"7.64","89h":"7.42","90h":"","92h":"7.99","93h":"","95h":"8.65","97h":"","98h":"10.65"},{"date":"2026-08-01","province":"青海","0h":"7.56","89h":"7.44","90h":"","92h":"7.93","93h":"","95h":"8.50","97h":"","98h":"9.26"},{"date":"2026-08-01","province":"天津","0h":"7.64","89h":"7.38","90h":"","92h":"7.96","93h":"","95h":"8.41","97h":"","98h":"9.91"},{"date":"2026-08-01","province":"贵州","0h":"7.74","89h":"7.64","90h":"","92h":"8.10","93h":"","95h":"8.56","97h":"","98h":"9.56"},{"date":"2026-08-01","province":"陕西","0h":"7.53","89h":"7.41","90h":"","92h":"7.85","93h":"","95h":"8.30","97h":"","98h":"9.48"},{"date":"2026-08-01","province":"新疆","0h":"7.39","89h":"0.00","90h":"","92h":"7.74","93h":"","95h":"8.29","97h":"","98h":"9.27"},{"date":"2026-08-01","province":"江苏","0h":"7.60","89h":"7.44","90h":"","92h":"7.94","93h":"","95h":"8.44","97h":"","98h":"10.51"},{"date":"2026-08-01","province":"北京","0h":"7.69","89h":"7.46","90h":"","92h":"7.97","93h":"","95h":"8.48","97h":"","98h":"9.98"},{"date":"2026-08-01","province":"安徽","0h":"7.67","89h":"7.42","90h":"","92h":"7.92","93h":"","95h":"8.47","97h":"","98h":"9.97"}]},"cache":true,"generated_at":"2026-08-01 14:18:19"}
查询指定省份各标号汽油的当前价格、涨跌幅、涨跌率,以及上次/下次油价调整时间。
| Header名称 | 默认值 | 必填 | 说明 |
|---|---|---|---|
X-API-Key |
你的API密钥
|
是 | 逗号APIKEY,用户后台首页获取 |
Content-Type |
application/json
|
是 | 请求内容类型 |
| 参数名 | 默认值 | 必填 | 说明 |
|---|---|---|---|
api_id |
23 |
是 | API接口ID,系统默认 |
endpoint_id |
ep_jm4ggrxvu_1785564497558 |
是 | 端点ID,系统默认 |
method |
POST |
是 | 请求方式,可选值:GET,POST |
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
province |
string | 是 | 省份名称,如:安徽、广东、上海等 | |
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
success |
boolean | 请求是否成功 | |
data |
object | 油价行情数据 | |
cache |
boolean | 是否来自缓存(true=缓存,false=实时获取) | |
generated_at |
string | 数据生成时间 | |
data.province |
string | 省份名称 | |
data.before_change_time |
string | 最近一次油价调整时间(YYYYMMDD) | |
data.next_change_time |
string | 下一次油价调整时间(YYYYMMDD) | |
data.{油号}.price |
string | 当前价格(元/升) | |
data.{油号}.change_before_price |
string | 最近一次调整前价格(元/升) | |
data.{油号}.change |
string | 涨跌额(元),负数表示降价 | |
data.{油号}.change_percent |
string | 涨跌率(%) | |
{"success":true,"data":{"province":"安徽","0h":{"change_before_price":"7.11","price":"7.67","change":"0.56","change_percent":"7.876%"},"89h":{"change_before_price":"6.91","price":"7.42","change":"0.51","change_percent":"7.381%"},"90h":{"change_before_price":"","price":"","change":"","change_percent":""},"92h":{"change_before_price":"7.38","price":"7.92","change":"0.54","change_percent":"7.317%"},"93h":{"change_before_price":"","price":"","change":"","change_percent":""},"95h":{"change_before_price":"7.90","price":"8.47","change":"0.57","change_percent":"7.215%"},"97h":{"change_before_price":"","price":"","change":"","change_percent":""},"98h":{"change_before_price":"9.40","price":"9.97","change":"0.57","change_percent":"6.064%"},"before_change_time":"20260801","next_change_time":"20260815"},"cache":false,"generated_at":"2026-08-01 14:19:30"}
{"success":false,"error":"missing_province","message":"请提供省份参数"}
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
405 |
405 | method_not_allowed | 仅支持GET和POST |
500 |
500 | config_error | 服务配置异常 |
502 |
502 | query_failed | 油价数据获取失败 |
| 错误代码 | HTTP状态 | 错误信息 | 详细说明 |
|---|---|---|---|
401 | HTTP 401 | 认证失败 | 请求头中缺少 X-API-Key 或 API Key 无效 |
400 | HTTP 400 | 参数错误 | 缺少必要参数(api_id、endpoint_id、method)或必填业务参数缺失 |
404 | HTTP 404 | 资源不存在 | API不存在、已下架或端点不存在 |
403 | HTTP 403 | 未开通 | 您尚未开通此API,请先开通 |
405 | HTTP 405 | 方法不允许 | 请求方法不在端点允许列表中 |
402 | HTTP 402 | 积分不足 | 账户积分不足以调用该API |
500 | HTTP 500 | 服务器内部错误 | 系统异常 |
浙公网安备 33059102000262号