raw.news.articles

News articles

Coming soonBetaFree quota applies

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

Global news by keyword and time window, with summary, sentiment and entities.

Price at launch: $0.0015 / call$1.5 per 1k$1 per 1k after 5M a month
Billing: Charged only for successful, non-empty resultsfree quota first
Scope: raw:newsThe API key needs this scope
Rate cap: 50 req/s globalAcross all users, plus your per-minute limit

Coming soon

The parameters and response format are settled, but no data source is connected yet. A call now gets 503 endpoint_unavailable and is not charged.

Parameters

Sent as query parameters

Only these parameters are accepted; any other one returns 400.

querystringRequired

Search keywords

Max 200 chars

Examplesemiconductor earnings

sincestring

Time window: a number plus h (hours) or d (days), such as 24h or 7d

Default24hPattern^[0-9]+(h|d)$

regionstring

Two-letter country or region code, such as us

Max 2 charsMin 2 chars

limitinteger

Number of results

Default20Range1–50

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

Replace $QOVIA_KEY with your API key

Example response200 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
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code