新闻开放 API
通过 REST 接口获取已入库的全球新闻数据，按密钥与套餐额度计量。
认证方式
所有请求需携带请求头 X-API-Key，密钥在控制台「API Keys」创建，明文仅创建时展示一次。
请求头示例
X-API-Key: onk_xxxxxxxxxxxxxxxx
接口列表
GET /open/v1/news：分页查询已入库新闻，按发布时间倒序。
| 参数 | 类型 | 说明 |
|---|---|---|
| page | integer | 页码，从 1 开始，默认 1 |
| pageSize | integer | 每页条数 1-100，默认 20 |
| dateFrom | string | 发布日期起（yyyy-MM-dd，含当日） |
| dateTo | string | 发布日期止（yyyy-MM-dd，含当日） |
| dimension | string | 维度代码过滤，如 D1 |
| subDimension | string | 子维度代码过滤，如 D1-1 |
| keyword | string | 标题/摘要关键词 |
响应结构
| 参数 | 类型 | 说明 |
|---|---|---|
| items | array | 新闻列表（标题、摘要、来源、发布时间、URL、维度归属等） |
| items[].content | string | 新闻正文（完整文本） |
| items[].titleZh | string | null | 标题的简体中文翻译（非中文新闻提供） |
| items[].summaryZh | string | null | 摘要的简体中文翻译（非中文新闻提供） |
| items[].contentZh | string | null | 正文的简体中文翻译（非中文新闻提供，翻译完成前为 null） |
| items[].facts | object | null | 核心事实要素：event（事件概括）、subjects（涉事主体列表）、places（地点列表）、time（事件时间），历史新闻可能为 null |
| total | integer | 符合条件的总条数 |
| page / pageSize | integer | 当前页码与每页条数 |
错误码
| 参数 | 类型 | 说明 |
|---|---|---|
| 401 KEY_INVALID | string | 缺少 X-API-Key 或密钥无效 |
| 403 KEY_DISABLED | string | 密钥已被停用 |
| 403 SUBSCRIPTION_EXPIRED | string | 订阅不存在、已到期或已停用 |
| 429 QUOTA_EXCEEDED | string | 已超出套餐请求额度 |
调用示例
curl
curl "https://your-domain/open/v1/news?page=1&pageSize=20" \ -H "X-API-Key: onk_xxxxxxxxxxxxxxxx"
JavaScript (fetch)
const res = await fetch("/open/v1/news?page=1&pageSize=20", {
headers: { "X-API-Key": "onk_xxxxxxxxxxxxxxxx" },
});
const { data } = await res.json();
console.log(data.items, data.total);需要 API 密钥？查看价格，注册后在控制台「API Keys」创建。