raw.news.articles

新闻文章检索

即将上线Beta可用免费额度

GEThttps://api.qovia.ai/v1/raw/news/articles

按关键词和时间窗检索全球新闻，返回标题、摘要、情感和实体。

上线后价格: $0.0015 / 次$1.5 / 千次每月超过 500 万次后 $1 / 千次
计费: 成功且有结果才扣费优先用免费额度
权限: raw:newsAPI Key 需要这个 scope
限速: 全局 50 次/秒所有用户合计，另有账户每分钟上限

即将上线

参数和返回格式已经确定，但还没有接入数据源。现在调用会收到 503 endpoint_unavailable，不会扣费。

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

querystring必填

检索关键词

最多 200 字

示例semiconductor earnings

sincestring

时间窗：数字加 h（小时）或 d（天），如 24h、7d

默认24h格式^[0-9]+(h|d)$

regionstring

两位国家或地区代码，如 us

最多 2 字至少 2 字

limitinteger

返回条数

默认20范围1–50

curl 'https://api.qovia.ai/v1/raw/news/articles?query=semiconductor+earnings' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": [
    {
      "id": "web_new_861b",
      "src": "web",
      "platform": "news",
      "lang": "en-US",
      "title": "Chipmaker beats estimates on AI demand",
      "sentiment": {
        "score": 0.41,
        "label": "positive"
      },
      "entities": [
        "semiconductor",
        "earnings"
      ]
    }
  ],
  "meta": {
    "billed": true,
    "charged_usd": "0.001500",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.998500",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码