全国油价查询免费 API 接口详解与调用实战(PHP / Python)

简介: 本文详解接口盒子提供的免费全国油价API:支持查询31省汽油(89/92/95/98等)、柴油、CNG/LNG等全品类实时价格及涨跌幅度,含多价区(如四川分一、二价区),每10个工作日更新,附PHP/Python调用示例与避坑指南。

本文基于接口盒子提供的全国油价查询免费 API整理而来,面向开发者做一份更系统、可照抄使用的教程。一般每 10 个工作日调整一次,覆盖汽油、柴油、CNG / LNG 等品类,对做车主类 App、物流成本测算、财经小工具都很实用。


一、接口能干嘛

一句话:给定「省 / 直辖市」名字,返回该省当前最新调价周期下的各品类油价 + 波动幅度,部分省份还会按「价区」拆分(比如四川分一价区、二价区,二价区含凉山州、攀枝花)。

支持油品包括但不限于:

  • 汽油:89 / 92 / 95 / 98
  • 乙醇汽油:e92 / e95 / e98
  • 爱跑系列:ap95 / ap98,以及乙醇版 ape95 / ape98
  • 柴油:0h、-10h、-20h、-35h、站库价 zyk
  • 天然气:CNG / LCNG / LNG

价格波动字段(xxbd)为负数即代表降价,正数就是涨价,单位是元/升(柴油同理)。


二、接口基本信息

项目

内容

请求地址

https://cn.apihz.cn/api/jinrong/youjia.php

请求方式

GET 或 POST 均可

数据格式

返回 JSON

费用

接口本身免费

公共 ID

示例使用公共 ID,生产环境建议换成自己的 ID/KEY 独享频次


三、请求参数(必填 3 个)

参数

名称

必填

说明

id

用户 ID

✅

用户中心的数字 ID,如 id=10000000

key

通讯秘钥

✅

用户中心生成的 KEY

sheng

省 / 直辖市

✅

中文名,如 sheng=四川、sheng=北京


四、返回参数速览

顶层字段:

  • code:200 成功 / 400 错误
  • msg:提示信息
  • sheng:省名
  • date:本次调价时间,如 2026年07月03日
  • data:对象,内含 data1/ data2…… 多个价区

单个价区(data1为例)核心字段:

  • jq:价区名(如一价区 / 二价区)
  • area:价区范围(有的省为空)
  • 92/ 95/ 98/ 89:对应汽油价格
  • 92bd/ 95bd…:对应波动
  • 0h/ 10h/ 20h/ 35h:柴油
  • cng/ lcng/ lng:天然气
  • 乙醇 / 爱跑系列字段同理,不一一列举

💡 某地区没卖的油品,对应字段会返回 null,解析时别硬取值。


五、返回示例

{
  "code": 200,
  "sheng": "四川",
  "date": "2026年07月03日",
  "data": {
    "data1": {
      "jq": "一价区",
      "area": "",
      "92": 7.28,
      "92bd": -0.76,
      "95": 7.78,
      "95bd": -0.81,
      "ap98": 8.88,
      "ap98bd": -0.92,
      "0h": 6.88,
      "0hbd": -0.78,
      "10h": 7.30,
      "10hbd": -0.82
    },
    "data2": {
      "jq": "二价区",
      "area": "含凉山州、攀枝花",
      "92": 7.35,
      "92bd": -0.76,
      "95": 7.85,
      "95bd": -0.81,
      "ap98": 8.95,
      "ap98bd": -0.93,
      "0h": 6.97,
      "0hbd": -0.77
    }
  }
}

可以看到这一轮四川 92 降了 0.76 元、95 降了 0.81 元,二价区比一价区略贵几分钱。


六、调用示例:PHP

方式 A · GET(最简单)

<?php
$id    = '88888888';   // 换成你自己的
$key   = '88888888';
$sheng = '四川';
$url = "https://cn.apihz.cn/api/jinrong/youjia.php?"
     . "id={$id}&key={$key}&sheng=" . urlencode($sheng);
$json = file_get_contents($url);
$data = json_decode($json, true);
if ($data['code'] == 200) {
    echo "省:{$data['sheng']},调价时间:{$data['date']}\n";
    foreach ($data['data'] as $k => $zone) {
        echo "--- {$zone['jq']} ({$zone['area']}) ---\n";
        echo "92#: {$zone['92']} 元(波动 {$zone['92bd']})\n";
        echo "95#: {$zone['95']} 元(波动 {$zone['95bd']})\n";
        echo "0号柴油: {$zone['0h']} 元\n";
    }
} else {
    echo "接口错误:{$data['msg']}\n";
}

方式 B · POST(curl,更正式)

<?php
$id    = '88888888';
$key   = '88888888';
$sheng = '四川';
$ch = curl_init('https://cn.apihz.cn/api/jinrong/youjia.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'id'    => $id,
        'key'   => $key,
        'sheng'=> $sheng,
    ]),
]);
$json = curl_exec($ch);
curl_close($ch);
$data = json_decode($json, true);
// 后面解析逻辑同上

七、调用示例:Python

方式 A · GET(requests)

import requests
api_id = "88888888"
api_key = "88888888"
sheng = "四川"
url = "https://cn.apihz.cn/api/jinrong/youjia.php"
params = {
    "id": api_id,
    "key": api_key,
    "sheng": sheng,
}
resp = requests.get(url, params=params)
resp.raise_for_status()
data = resp.json()
if data["code"] == 200:
    print(f"省:{data['sheng']}|调价时间:{data['date']}")
    for k, zone in data["data"].items():
        print(f"--- {zone['jq']} ({zone.get('area','')}) ---")
        print(f"92#:{zone.get('92')} 元(波动 {zone.get('92bd')})")
        print(f"95#:{zone.get('95')} 元(波动 {zone.get('95bd')})")
        print(f"0号柴油:{zone.get('0h')} 元")
else:
    print("接口错误:", data["msg"])

方式 B · POST

resp = requests.post(url, data=params)
# 后面解析完全一致

八、几个容易踩的小坑

  1. 多价区省份:别只认 data1,凉山、攀枝花这种地方在 data2,要 for着读。
  2. null字段:部分地区不卖 98、不卖 -35 柴油,解析时用 get()或 ??(PHP)兜底,别直接下标。
  3. 波动是相对上轮调价的差值,不是百分比,单位是元/升。

九、适用场景随想

  • 车主小程序:「加满一箱 92 比上次省几块钱」
  • 物流后台:按省份拉柴油价算干线成本
  • 财经类站点:每次调价日自动发快讯

接口本身免费 + 返回字段细到爱跑 / 乙醇 / CNG 都有,算是国内这类数据里比较省事的一个。

目录
相关文章
|
4月前
|
API
油价查询-今日油价查询-汽油价格查询-柴油价格查询-历史油价查询-国内油价查询-国际油价查询API接口介绍
本文介绍两款权威油价API:国内版支持全国300+城市、10000座加油站实时油价查询(含89/92/95/98号汽油及0号柴油),同步中石化、中石油出厂价;国际版提供WTI与布伦特原油历史行情,涵盖开盘、收盘、涨跌幅等全维度数据。
1454 0
|
JavaScript
关于“wap2app仅支持对已通过ICP备案的域名站点进行打包”问题解决
关于“wap2app仅支持对已通过ICP备案的域名站点进行打包”问题解决
关于“wap2app仅支持对已通过ICP备案的域名站点进行打包”问题解决
|
29天前
|
人工智能 自然语言处理 前端开发
2026年必装的9个Claude Code插件
去年这个时候,Claude Code 还只是一个"能聊天的终端"。今年再用,我的工作流已经完全变了样:提交代码前它自己先做 code review,写功能前它先把代码库摸一遍,连浏览器自动化都能一句话触发。撑起这套工作流的不是 Claude 模型变强了,而是插件(Plugins)——一个命令装进斜杠命令、子代理、hooks 和 MCP Server 的打包分发机制。
|
3月前
|
JSON API 数据安全/隐私保护
免费外汇汇率查询接口推荐:官方稳定方案与开源可用清单
本文实测推荐4个免费外汇汇率接口:Frankfurter(ECB数据,免Key、支持1999年起历史)、fawazahmed0(200+币种含加密货币、无速率限制)、open.er-api(160+币种、一行URL获取)、万维易源(官方自营,含K线/转换等多接入点,需appKey)。均经真实连通验证,适配跨境电商、旅行记账与金融学习场景。
1411 1
免费外汇汇率查询接口推荐:官方稳定方案与开源可用清单
|
3月前
|
JSON 缓存 小程序
全国油价查询 API—今日汽油柴油价格数据接口
全国油价查询API是权威、稳定、高并发的标准化接口,覆盖全国31省7类油品(89#–97#汽油+0#柴油),每日凌晨7点同步国家发改委数据,支持GET/JSON/多鉴权,50ms响应,100% SLA,免费试用100次。
1049 0
全国油价查询 API—今日汽油柴油价格数据接口
|
4月前
|
弹性计算 缓存 运维
阿里云ECS磁盘空间满了处理教程:从诊断到扩容的一线经验
ECS 实例突然写入失败、网站报 503 或数据库连接不上,运维群里最常跳出的截图就是 df -h 里那行触目惊心的 Use% 100%。阿里云的云盘扩容不算复杂,但真正让业务停摆的,往往不是扩容本身有多难,而是事前没做分层监控、事后清理时又不小心踩了 inode 耗尽或文件句柄占用的坑。这篇教程不会把 100 篇文档重复一遍,而是直接聚焦三个关键动作:诊断真实占用源、安全清理大文件,以及在线扩容到文件系统生效的全链路。
652 1
|
4月前
|
API PHP Python
台风实时与历史详情查询免费 API 接口完整教程
该台风API接口覆盖实时与历史数据,提供台风基础信息、逐时路径、四象限风圈半径、120小时预报等精细化字段,支持year查列表、no查详情两种调用模式,适用于路径动画、影响评估等专业场景。(239字)
1098 0
|
4月前
|
API
菜谱查询-菜谱大全-家常菜谱查询API接口介绍
本菜谱API提供超十万条权威菜谱数据,支持按分类、关键词精准查询,返回菜名、步骤、配料及图片。适用于解决“吃什么”难题、新手学厨、营养搭配、特殊饮食需求及剩菜利用等场景,助力健康智慧烹饪。
320 0
|
5月前
|
自然语言处理 供应链 安全
高认知的本质,基于真实信息的规则推演,关于Agent的设计规范
本文提出面向开放域、多规则交叉与高风险场景的通用认知Agent设计规范,强调“真实信息→规则推演→独立验证”三阶闭环。主张以强制检索保信息真实、分层专精架构兼顾知识广度与推理深度、内置多源交叉验证回路,并输出带三维置信度的结论,核心目标是构建可信赖、可追溯、可验证的可靠认知系统。(239字)
413 0
|
6月前
|
人工智能 搜索推荐 JavaScript
别再手动刷热搜了——我让Hermes每天自动分析热点和产品的结合点,还帮我出好了选题
Hermes Agent是Nous Research开源的自进化AI智能体(MIT协议),支持私有部署、持久记忆与闭环学习。本文介绍如何用它自动抓取微博、抖音等多平台热点,结合你的产品信息每日生成精准选题与大纲——三步配置,省去手动刷榜筛热的低效劳动。
1913 2