TrendNews API
News digests, original-source links and trends across 111 countries. Filter by country, category, date and topic.
Authorization
Send your key in the Authorization header. Never include it in a URL or publish it in frontend code.
Authorization: Bearer dev_live_YOUR_KEYhttps://dev.uk.app/api/v1
TrendNews API
News digests, original-source links and trends across 111 countries. Filter by country, category, date and topic.
One successful response costs one daily unit, including lists and health checks. Invalid or failed responses and cached idempotent retries do not consume units. The minute limit applies to each key; the daily quota is shared across all keys of the account.
| GET | Documentation |
|---|---|
/trendnews/health | JSON |
/trendnews/countries | ISO-2 |
/trendnews/categories?country=UA | Filters and pagination |
/trendnews/posts | Filters and pagination |
/trendnews/posts/{id} | Posts include title, digest, category, publication time and original-source links. Retain source attribution. |
/trendnews/trends | country · date · top |
curl 'https://dev.uk.app/api/v1/trendnews/posts?country=UA&limit=5' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Idempotency-Key: news-example-001'Filters and pagination
Use ISO-2 country codes; dates are YYYY-MM-DD. limit: 1–100; offset: 0–1,000,000; top: 1–50. q: up to 100 characters. Categories require country.
Posts include title, digest, category, publication time and original-source links. Retain source attribution.
Provider: TrendNews. Subscriptions bought on dev.uk.app apply here. They do not change direct-site subscriptions or API keys.
Quotas and billing
Each API has its own allowance. Weather + IP use the existing bundle; TrendNews has a separate subscription.
Weather and IP quotas reset each UTC calendar month. TrendNews quotas reset daily at 00:00 UTC, including annual subscriptions. Excess requests are blocked; no automatic overage charges.
X-Quota-Limit: 10000
X-Quota-Remaining: 9999
X-Quota-Reset: 1793491200
X-Request-ID: 00000000-0000-0000-0000-000000000000400 invalid input · 401 invalid key · 403 API scope denied · 409 idempotency conflict · 429 quota/rate limit · 503 upstream unavailable. Quota failures include Retry-After.
Optional Idempotency-Key protects retries for the same account, API, endpoint and input. Replays are free for ten minutes. The temporarily cached response is encrypted, then deleted. Request history retains only endpoint, status, units and timing for 30 days.
Data sources
Weather: Open-Meteo · IP: DB-IP Lite · CC BY 4.0. Retain attribution when displaying or redistributing data. Source information is included in API responses.
Try an API request
Send your key in the Authorization header. Never include it in a URL or publish it in frontend code.
