API documentation

QNews API v1

Integrate fresh news search, top stories, category feeds, resolved publisher URLs, and optional article-content extraction from your backend service.

Get API key OpenAPI YAML Contact support

Quick start

Use QNews from another app.

1. Create account

2. Create key

Create an API key in /dashboard. Copy it immediately; it is only shown once.

3. Call API

Send the key with X-API-Key or Authorization: Bearer.

4. Keep it server-side

Store keys in environment variables or a secret manager, never in browser code.

Base URL

`https://qnews.quantosei.com`

All commercial endpoints live under /v1/news. Legacy open endpoints such as /news/search return 410 Gone.

curl "https://qnews.quantosei.com/v1/news/search?q=artificial%20intelligence&limit=10" \
  -H "X-API-Key: qnews_your_api_key"

Endpoints

Method	Endpoint	Description
GET	`/v1/news/search?q=...`	Search news. Requires `q`.
GET	`/v1/news/top-stories`	Fetch top stories for a locale.
GET	`/v1/news/category/:category`	Fetch by category.
GET	`/v1/news/categories`	List category names.

Query parameters

Name	Notes
`limit`	Default 25. Capped by plan: Starter 25, Pro 50, Business 100.
`includeContent=true`	Pro, Business, and Enterprise only. Consumes content units.
`include_content=true`	Snake-case alias for integrations that prefer it.
`hl`, `gl`, `ceid`	Google News locale controls. Defaults are `hl=en`, `gl=US`.

Supported category names.

world, nation, business, technology, entertainment, sports, science, health

Example response

Stable JSON shape for integrations.

{
  "data": [
    {
      "title": "Article title",
      "link": "https://publisher.example/story",
      "image": "",
      "source": "Publisher",
      "datetime": "2026-06-18T08:42:00.000Z",
      "time": "Thu, 18 Jun 2026 08:42:00 GMT",
      "articleType": "regular",
      "favicon": "https://publisher.example/favicon.ico",
      "content": ""
    }
  ],
  "meta": {
    "count": 1,
    "includeContent": false,
    "plan": "Starter",
    "usage": {
      "requestsThisMonth": 42,
      "contentUnitsThisMonth": 0,
      "monthlyRequestLimit": 25000,
      "contentExtractionLimit": 0
    }
  }
}

Treat image, favicon, and content as optional strings that may be empty. Content extraction is best effort because some publishers block or restrict article text.

PowerShell

$env:QNEWS_API_KEY = "qnews_your_api_key"
Invoke-RestMethod -Uri "https://qnews.quantosei.com/v1/news/search?q=technology&limit=3" -Headers @{ "X-API-Key" = $env:QNEWS_API_KEY }

Node.js backend

const response = await fetch("https://qnews.quantosei.com/v1/news/top-stories?limit=5", {
  headers: { "X-API-Key": process.env.QNEWS_API_KEY }
});
const payload = await response.json();
if (!response.ok) throw new Error(payload.message);

Errors

Plan for these responses.

Status	Error	Meaning
400	`missing_query`	Search called without `q`.
401	`missing_api_key` or `invalid_api_key`	Key missing, revoked, invalid, or user disabled.
402	`subscription_required`	No active or trialing subscription.
403	`email_not_verified`, quota, or content restriction	Account or plan does not allow the request.
429	`rate_limited`	Per-minute limit exceeded. Retry with backoff.