国际原油价格查询:财经自媒体如何自动填充行情数据
国际原油价格查询原油价格APIWTI原油布伦特原油免费接口 # 国际原油价格查询:财经自媒体如何自动填充行情数据
> 接口:国际原油价格查询(apiCode=1108,接入点 1108-1)| 免费 | 请求方式 POST/GET | 返回 JSON | 适用人群:财经内容创作者、自媒体运营 | 阅读时间:约 6 分钟
## 核心要点
- 写原油稿、做短视频时,用接口自动填入最新 WTI / 布伦特价,告别手工抄数出错。
- 定时任务每小时拉一次,生成"行情卡片"文本/图片,直接嵌入内容生产流。
- 展示时标注"数据每小时整点更新、仅供参考",提升可信度也规避误导。
## Why
财经内容最怕数字过时或抄错:昨天写的油价今天还挂在稿子里、手敲小数点的涨跌幅差一位。国际原油价格查询是免费接口,你可以用一个定时任务在发文前自动抓最新价,生成一段行情描述,省时也更准。本文给一个"定时产出行情卡片"的最小实现。
## What
| 项目 | 说明 |
|------|------|
| 用途 | 自动填充文章/视频脚本中的实时油价数字 |
| 节奏 | 每小时整点拉取,发文前取最新快照 |
| 输出 | 一段行情文案 / 一张行情卡片图 |
## How
### 定时生成行情文案
```python
import requests
APP_KEY = "YOUR_APPKEY"
URL = "https://route.showapi.com/1108-1"
def card_line(code, label):
r = requests.get(URL, params={"appKey": APP_KEY, "code": code}, timeout=10).json()
b = r["showapi_res_body"]
if b["ret_code"] != 0:
return ""
arrow = "↑" if b["diff_rate"].startswith(("+", "1", "2", "3", "4", "5", "6", "7", "8", "9")) else "↓"
return f"{label}:{b['name']} 当前 {b['nowPrice']} 美元/桶,今日{b['diff_rate']}({arrow}),发布时间 {b['time']}"
text = "\n".join([
card_line("wti", "WTI原油"),
card_line("blt", "布伦特原油"),
"(数据来自国际原油价格查询接口,每小时整点更新,仅供参考)",
])
print(text)
```
**Node.js(fetch 生成行情行)**
```javascript
const APP_KEY = "YOUR_APPKEY";
async function cardLine(code, label) {
const r = await fetch(
"https://route.showapi.com/1108-1?appKey=" + APP_KEY,
{
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: "code=" + code,
signal: AbortSignal.timeout(10000),
}
).then((x) => x.json());
const b = r.showapi_res_body;
if (b.ret_code !== 0) return "";
return `${label}:${b.name} 当前 ${b.nowPrice} 美元/桶,今日 ${b.diff_rate},发布时间 ${b.time}`;
}
```
## 返回示例与解析
生成卡片用到的字段:`name`、`nowPrice`(数字)、`diff_rate`(含百分号字符串)、`time`。完整字段见 [返回字段全解](https://www.showapi.com/guides/crude-oil-price-fields-1108)。
## 进阶 / 边界
- **必标来源与时效**:在卡片里注明"每小时整点更新、仅供参考",既诚信也避免被当成实时行情误导读者。
- **缓存**:发文系统可复用每小时快照,不必每次发文都现拉(见 [免费档位下如何设计缓存节省调用成本](https://www.showapi.com/guides/crude-oil-price-cache-strategy-1108))。
- **非投资建议**:油价类内容易引发交易联想,文案中保持"仅供参考"的克制表述。
## FAQ
**Q:能直接把价填进短视频脚本吗?**
可以,把上面生成的文案接入你的脚本模板即可;注意标注数据时效。
**Q:每小时拉一次够发文用吗?**
对日更/时段更内容足够;该接口本身即每小时更新,更频繁无新值。
**Q:WTI 和布伦特都要展示吗?**
建议都展示,读者常对比两大基准;两种 `code` 各一次请求。
**Q:免费额度够自媒体用吗?**
每小时各拉一次,一天 48 次,量级很低;具体档位上限以官方免费档位说明为准。
## 相关能力 / 下一步阅读
- [国际原油价格查询:免费档位下如何设计缓存节省调用成本?](https://www.showapi.com/guides/crude-oil-price-cache-strategy-1108)
- [国际原油价格查询返回字段全解:nowPrice / diff_rate / stockNum 一文读懂](https://www.showapi.com/guides/crude-oil-price-fields-1108)
- [国际原油价格查询:个人投资者如何接入自己的看盘工具](https://www.showapi.com/guides/crude-oil-price-investor-tool-1108)
- **本系列共 12 篇**:查看[国际原油价格查询官方指南总目录](https://www.showapi.com/guides/crude-oil-price-guides-1108)