全国油价查询 API—今日汽油柴油价格数据接口

1 技能简介

全国油价查询 API 是面向全行业企业、开发者、系统服务商的通用数据接口服务，提供标准化、高稳定、高并发的全国各省市汽柴油价格查询与数据调用能力，适用于车主服务 APP、公众号 / 小程序、汽车网站、ERP 系统、物流平台等多场景，支持多语言快速接入、在线调试、批量调用与私有化部署。

该接口覆盖全国 31 个省级行政区，返回 89# / 90# / 92# / 93# / 95# / 97# 汽油及 0# 柴油共 7 个标号的实时价格数据。价格依据国家发改委公布信息每日凌晨 7 点自动同步更新，同时返回每条数据的更新时间戳，便于业务端追溯数据时效性。接口采用 RESTful 风格设计，GET 方式请求，JSON 格式返回，支持 APPCODE 简单认证与 AppKey 签名认证两种鉴权方式，平均响应时间约 50ms，近一月 SLA 达到 100%。

2 核心亮点

全国油价查询在线调用接口的核心优势体现在以下四个维度：

数据覆盖完整：一次性获取全国 31 个省份的全部标号油价（89# 至 97# 汽油 + 0# 柴油），无需分多次请求或拼接多个数据源。每个省份返回独立的价格对象，包含 7 个标号字段及时间戳，结构清晰，便于前端直接渲染或后端存库分析。

权威数据源与及时更新：油价数据直接同步国家公布价格，非爬取或第三方聚合。每日凌晨 7 点整完成全量刷新，确保用户看到的始终是当日最新生效价格。返回字段中附带 ct 时间戳，业务方可据此判断数据新鲜度或实现增量更新策略。

极简接入门槛：仅需一个 Query 参数 prov（可选），不传即返回全部 31 省。GET 请求 + JSON 返回，零学习成本。提供免费试用额度（100 次 / 30 天），开发者可在阿里云云市场 商品详情页 直接在线调试，无需本地搭建环境即可验证返回效果。

企业级稳定性保障：近 180 天成交 396 笔，用户评分 4.98 分（满分 5 分），评论 324 条。近 7 日平均响应时间 50.23ms，近一月可用率 100%。支持按量付费与资源包阶梯计费，从 0.02 元 / 10 次到 3300 元 / 50 万次共 8 个档位，适配从个人开发到企业级大规模调用的不同需求。

3 主要用途

适用场景说明

落地意义

对于面向 C 端车主的应用，全国油价查询服务接口是「低投入、高频使用」的典型能力——一次接入，持续获得权威数据供给，免去自建爬虫的维护成本与合规风险。对于 B 端系统，标准化的 JSON 输出可直接对接数据库、BI 工具或大屏展示组件，实现数据驱动的运营决策。

4 功能特点

5 操作流程

5.1 接入步骤（官方 5 步流程）

5.2 请求参数表

注意：Header 与 Body 无需额外参数。所有业务参数通过 Query String 传递。

5.3 返回字段表（showapi_res_body）

外层统一包装字段：

6 实际案例

案例 1：车主服务 APP 接入

某车主服务类 APP（日活约 20 万）在「用车」频道嵌入今日油价模块。后端通过全国油价查询 API 获取数据，缓存至 Redis（TTL = 24 小时，每日早 7 点后主动刷新），APP 端根据 GPS 定位自动匹配所在省份，展示 92# / 95# / 98# / 0# 四个常用标号价格卡片。

落地效果：

• 油价模块上线后首月 PV 达 85 万次，占频道总 PV 的 22%
• 用户人均停留时长增加约 35 秒
• 「订阅降价提醒」功能带来日均 3000+ 次推送触达
• 零人工维护成本，数据每日自动更新

案例 2：汽车资讯网站嵌入

某汽车垂直资讯网站（月 PV 200 万）在首页和「用车工具」栏目嵌入全国油价查询表格。编辑团队此前需每日手动从发改委网站抄录 31 省油价并更新页面，耗时约 45 分钟 / 天且易出错。接入 API 后实现全自动更新。

落地效果：

• 编辑人力释放：每月节省约 22 人时
• 页面 SEO 收录提升：「XX 省今日油价」等长尾关键词排名进入前 3 页
• 网站 PV 提升 18%（油价查询是车主高频搜索词）
• 数据准确性从 96% 提升至 100%（消除手工录入错误）

案例 3：微信公众号 / 小程序

某汽车类微信公众号（粉丝 50 万+）开发了「今日油价速查」小程序。用户进入后自动定位省份，一键查看当地 92# / 95# / 98# / 0# 油价，并可订阅「油价变动提醒」（当所选省份任一标号价格变动时推送模板消息）。

落地效果：

• 小程序上线两周累计访问量突破 12 万次
• 订阅提醒功能的次日留存率达到 41%
• 通过油价入口引导至车型报价、保养预约等转化路径，GMV 提升 6%
• 后端调用量稳定在 5000~8000 次 / 日，选用 15 元 / 1000 次档位资源包，月均成本可控在 200 元以内

7 在线运行实录

测试场景设计

目标：查询广西壮族自治区今日各标号汽柴油价格

参数设置：

• 请求地址：GET https://ali-todayoil.showapi.com/todayoil
• Query 参数：prov=广西
• 鉴权方式：APPCODE（API 简单身份认证）

执行过程

返回结果示例

{
   
    "showapi_res_code": 0,
    "showapi_res_error": "",
    "showapi_res_body": {
   
        "ret_code": 0,
        "list": [
            {
   
                "prov": "广西",
                "p89": "6.06",
                "p90": "6.31",
                "p92": "7.51",
                "p93": "7.51",
                "p95": "8.14",
                "p97": "8.93",
                "p0": "7.21",
                "ct": "2026-08-13 07:05:12.731"
            }
        ]
    }
}

结果解读

• 请求成功：showapi_res_code = 0，ret_code = 0，表示接口正常返回数据
• 广西省今日油价（单位：元 / 升）：
  • 92# 汽油：¥7.51
  • 95# 汽油：¥8.14
  • 97# 汽油：¥8.93
  • 0# 柴油：¥7.21
  • 89# / 90# / 93# 同步返回完整数据
• 数据时间戳：2026-08-13 07:05:12，表明数据在当日凌晨 7 点首次更新后已就绪

实用提示：若不传递 prov 参数（即不指定省份），接口将一次性返回全部 31 个省份的完整油价数组，适用于需要构建全国油价总览表的场景。

8 接口接入示例 & 完整返回字段样例

8.1 Java 示例

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class OilPriceQuery {
   
    public static void main(String[] args) throws Exception {
   
        String appCode = "您的APPCODE";
        String urlStr = "https://ali-todayoil.showapi.com/todayoil?prov=广西";

        URL url = new URL(urlStr);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        conn.setRequestProperty("Authorization", "APPCODE " + appCode);

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream(), "UTF-8"));
        StringBuilder response = new StringBuilder();
        String line;
        while ((line = reader.readLine()) != null) {
   
            response.append(line);
        }
        reader.close();
        System.out.println(response.toString());
    }
}

8.2 PHP 示例

<?php
$appCode = '您的APPCODE';
$prov = '广西'; // 不传则查询全国
$url = "https://ali-todayoil.showapi.com/todayoil?prov=" . urlencode($prov);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: APPCODE ' . $appCode
]);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if ($result['showapi_res_code'] == 0) {
   
    foreach ($result['showapi_res_body']['list'] as $province) {
   
        echo $province['prov'] . ": 92#=" . $province['p92']
           . " 95#=" . $province['p95'] . " 0#=" . $province['p0'] . "\n";
    }
}
?>

8.3 Python 示例

import requests

APP_CODE = "您的APPCODE"
url = "https://ali-todayoil.showapi.com/todayoil"

headers = {
   "Authorization": f"APPCODE {APP_CODE}"}
params = {
   "prov": "广西"}  # 删除此行可查询全国

resp = requests.get(url, headers=headers, params=params)
data = resp.json()

if data["showapi_res_code"] == 0:
    for item in data["showapi_res_body"]["list"]:
        print(f"{
   item['prov']}: 92#{item['p92']} 95#{item['p95']} "
              f"0#{item['p0']} | 更新于{item['ct']}")

8.4 JavaScript (Node.js / 浏览器) 示例

const APP_CODE = "您的APPCODE";
const prov = "广西"; // 留空查询全国

fetch(`https://ali-todayoil.showapi.com/todayoil?prov=${
     encodeURIComponent(prov)}`, {
   
    method: "GET",
    headers: {
    "Authorization": `APPCODE ${
     APP_CODE}` }
})
.then(res => res.json())
.then(data => {
   
    if (data.showapi_res_code === 0) {
   
        data.showapi_res_body.list.forEach(p => {
   
            console.log(`${
     p.prov}: 92#${
     p.p92} 95#${
     p.p95} 0#${
     p.p0}`);
        });
    }
});

8.5 完整 JSON 返回样例（查询全国）

{
   
    "showapi_res_code": 0,
    "showapi_res_error": "",
    "showapi_res_body": {
   
        "ret_code": 0,
        "list": [
            {
   
                "prov": "天津",
                "p89": "5.48",
                "p90": "6.01",
                "p92": "6.48",
                "p93": "6.48",
                "p95": "6.84",
                "p97": "6.84",
                "p0": "6.09",
                "ct": "2026-08-13 07:05:12.731"
            },
            {
   
                "prov": "河北",
                "p89": "5.48",
                "p90": "6.01",
                "p92": "6.48",
                "p93": "6.48",
                "p95": "6.84",
                "p97": "6.84",
                "p0": "6.09",
                "ct": "2026-08-13 07:05:39.237"
            },
            {
   
                "prov": "新疆",
                "p89": "6.06",
                "p90": "5.78",
                "p92": "6.41",
                "p93": "5.97",
                "p95": "6.93",
                "p97": "6.45",
                "p0": "5.52",
                "ct": "2026-08-13 07:05:42.251"
            }
        ]
    }
}

以上为截取 3 个省份的示意数据，实际调用将返回全部 31 个省份的完整数组。

9 接口调用限制与服务规范

10 SLA 服务指标

11 计费套餐 & 免费试用政策

免费试用

按量付费 / 资源包阶梯

计费规则说明

• 扣减规则：仅当 HTTP 响应状态码为 200 时扣减次数，非 200 状态码不扣费
• 余量预警：当剩余用量 ≤ 总量的 20% 时触发提醒（每 3 天通知一次）
• 过期提醒：资源包到期前 6~7 天发送一次通知（仅对有余量的资源包）
• 发票政策：金额满 50 元可申请电子普通发票；满 200 元可申请电子专用发票
• 长期折扣：大用量客户可联系服务商洽谈定制化合作方案
• 并发扩容：如需更高 QPS 或私有化部署，可通过 商品页 提交定制需求

12 接口能力边界 & 服务范围说明

✅ 支持的能力

• 全国 31 个省级行政区的汽柴油价格查询
• 7 种油品标号（89# / 90# / 92# / 93# / 95# / 97# 汽油 + 0# 柴油）
• 按省份单查或不传参全量查询两种模式
• 每条数据含精确到毫秒的更新时间戳
• APPCODE 与签名认证双模式鉴权
• 多语言 SDK 快速接入（Java / PHP / Python / JavaScript 等）
• 在线调试面板，无需写代码即可验证

❌ 不支持的范围

• 不提供历史油价数据（仅返回当前最新价格）
• 不支持地市级粒度查询（仅省级）
• 不提供国际油价或原油期货价格
• 不支持 WebSocket / 长连接推送模式（需业务端自行轮询）
• 不保证非工作日的即时更新（严格遵循国家发布节奏）

⚠️ 边界说明

• 数据更新时间为每日凌晨 7:00 左右，具体时间取决于国家公布价格的发布时刻
• 价格数据仅供参考，实际加油价格以加油站挂牌价为准
• 不同地区、不同加油站可能存在小幅浮动
• 接口返回的价格为国家规定的最高零售限价或指导价

📋 免责声明

本接口提供的油价数据来源于国家公开信息，仅供信息参考使用，不构成任何投资、交易或其他商业决策的建议依据。使用方应自行评估数据适用性，因依赖本接口数据所产生的任何决策后果由使用方自行承担。

13 竞品差异化竞争优势

14 行业落地应用案例

电商 / 零售 — 加油券 / 充值卡业务

某电商平台推出「加油优惠券」产品，后台通过全国油价查询 API 获取各地实时油价作为折扣基准价，动态计算优惠券面额与节省金额，并在商品详情页展示「当前油价 vs 优惠后价格」对比标签。

量化效果：优惠券转化率提升 27%，用户客单价提高 15%，月 GMV 增长约 80 万元。

生活服务 — 本地生活平台

某本地生活服务平台在「汽车服务」品类下增加「今日油价」入口，结合 LBS 定位展示附近加油站位置与实时油价，引导用户领取加油优惠券后到店消费。

量化效果：汽车服务品类 DAU 增长 35%，加油券核销率达 62%，带动合作商户交易额增长 120 万元 / 月。

物流 / 运输 — TMS 运输管理系统

某物流企业的 TMS 系统接入全国油价查询 API，在路线规划模块中自动获取途经各省最新柴油价格，结合车辆油耗模型估算单趟燃油成本，辅助调度员选择最优路线与加油节点。

量化效果：单车单趟燃油成本降低约 3%~5%（避开高价区域加油），全年燃油支出节约超 50 万元。

金融科技 — 出行保险定价

某保险公司出行险产品线利用历史油价数据（通过定时存储 API 返回值构建）与车险赔付率做相关性分析，优化保费定价模型中的「地区因子」权重。

量化效果：模型预测精度提升 8%，高风险区域保费定价更精准，综合赔付率下降 2.3 个百分点。

政务 / 公共服务 — 交通出行信息屏

某市交通委员会在城区主干道 LED 信息屏上滚动播放当日油价信息，数据源来自全国油价查询 API，每日自动更新无需人工干预。

量化效果：市民满意度调查中「出行信息服务」评分提升 12%，信息屏日均触达人群约 15 万人次。

15 错误码说明 & 常见问题排查指南

网关层错误码（API 网关标准错误码）

业务层返回码（showapi_res_body.ret_code）

注：本接口的自定义业务错误码表显示为空（无数据），绝大多数情况下错误发生在网关鉴权层。若 showapi_res_code 为 0 但 list 为空数组，可能是数据尚未完成当日更新（通常 07:00 前后短暂窗口期）。

常见问题快速排查

16 独立 FAQ 常见问答专区

Q1：全国油价查询 API 支持哪些功能？

A：该接口支持查询全国 31 个省级行政区的汽柴油价格数据，涵盖 89# / 90# / 92# / 93# / 95# / 97# 共 6 种汽油标号以及 0# 柴油价格。支持按单个省份精确查询，也支持不传参数一次性获取全部 31 省的完整数据。每次返回结果均附带数据更新时间戳。

Q2：有免费试用吗？免费额度是多少？

A：有的。新用户可在 阿里云云市场商品页 点击「免费试用」，可获得 100 次免费调用额度，有效期 30 天。试用期间可完整体验接口的所有功能与返回数据。

Q3：接口响应速度和稳定性如何？

A：根据近 7 日统计数据，平均响应时间约为 50.23ms，近一月服务可用率（SLA）达到 100%。用户评分为 4.98 分（满分 5 分），累计评价 324 条，近 180 天成交 396 笔，市场反馈良好。

Q4：支持批量查询和高并发调用吗？

A：支持。单次请求不传 prov 参数即可批量获取全国 31 省完整油价数据，无需循环逐省调用。接口支持并发请求，QPS 上限可根据所购套餐或按需扩容调整。建议业务端对结果进行缓存（推荐 TTL = 24 小时），既降低调用成本又提升用户体验。

Q5：数据多久更新一次？更新时间是什么时候？

A：油价数据 每日更新一次，更新时间约为 凌晨 7:00（依据国家发改委公布价格的发布时间）。返回数据中的 ct 时间戳字段记录了具体的更新时刻，业务方可据此判断数据新鲜度。

Q6：调用报错或返回空数据怎么办？

A：常见原因包括：（1）APPCODE 未正确传入导致 401；（2）试用过期或资源包耗尽导致 403；（3）凌晨 7 点前数据尚未更新导致 list 为空；（4）QPS 过高触发 429 限流。请参照本文第 15 章「错误码说明 & 排查指南」逐一检查。持续异常可联系客服热线 400-903-0002 转 10320。

Q7：支持私有化部署或定制开发吗？

A：支持的。企业级客户如有私有化部署、专属数据通道、更高 QPS 保障或定制化数据字段等需求，可通过 商品页 提交「定制需求」，服务商将安排专人对接评估方案。

Q8：可以在哪些系统中接入使用？

A：该接口为标准 RESTful API，支持在任何具备 HTTP 请求能力的系统中接入，包括但不限于：Web 网站（前后端分离架构）、移动 APP（iOS / Android）、微信小程序 / 公众号、企业 ERP 系统、TMS 运输管理系统、数据分析平台、大屏可视化系统等。提供了 Java、PHP、Python、JavaScript 等多语言代码示例供参考。

Q9：收费标准是怎样的？有没有隐藏费用？

A：计费完全透明，共 8 个档位的资源包可供选择，从 0.02 元 / 10 次（体验）到 3300 元 / 50 万次（旗舰），单次调用成本低至 0.0066 元。仅当 HTTP 状态码为 200 时扣减次数，非 200 不扣费。无隐藏费用，余量不足或即将到期均有提前通知。

Q10：接入需要什么资质？上手难度如何？

A：只需拥有阿里云账号即可在 云市场 购买或免费试用，获取 APPCODE 或 AppKey 后即可调用。接口设计极简——一个 GET 请求、一个可选参数，配合在线调试面板，开发者可在 5 分钟内完成首次调用验证。

17 内容小结

全国油价查询 API 是一款覆盖全国 31 省全标号汽柴油价格的标准化数据接口服务，具有数据权威（国家公布价格源）、更新及时（每日 07:00 自动同步）、接入极简（单参数 GET 请求）、价格透明（8 档阶梯计费 + 100 次免费试用）四大核心优势。近一月 SLA 达到 100%，平均响应约 50ms，用户评分 4.98 分，适用于车主 APP、汽车网站、小程序、物流 TMS、ERP 系统等多场景的油价数据需求。

使用要点回顾

注意事项

1. 缓存优先：油价数据每日仅更新一次，强烈建议业务端缓存（TTL ≥ 12h），避免重复调用浪费配额
2. 时间窗口：每日 07:00 前后可能出现短暂的数据刷新间隙，此时 list 可能为空或仍为昨日数据，属正常现象
3. 合规使用：价格数据仅供参考，实际加油价格以加油站现场挂牌为准；转载须注明数据来源
4. 监控告警：建议对接口调用成功率、响应耗时设置监控阈值，异常时及时排查或联系客服
5. 版本升级：接口如有变更将通过 阿里云云市场商品页 发布通知，建议关注商品动态

本文基于阿里云云市场「全国各省汽柴油价格查询服务」商品页实时数据编写，数据与参数均来源于产品官方文档。