TrendNews API
Новинні дайджести, посилання на першоджерела та тренди зі 111 країн. Фільтри за країною, категорією, датою й темою.
Authorization
Передавайте ключ у заголовку Authorization. Не додавайте його до URL та не публікуйте у фронтенд-коді.
Authorization: Bearer dev_live_YOUR_KEYhttps://dev.uk.app/api/v1
TrendNews API
Новинні дайджести, посилання на першоджерела та тренди зі 111 країн. Фільтри за країною, категорією, датою й темою.
Одна успішна відповідь витрачає одну добову одиницю, зокрема список або перевірка стану. Невалідні, невдалі відповіді та кешовані ідемпотентні повтори квоту не витрачають. Хвилинний ліміт діє на кожен ключ, а добова квота спільна для всіх ключів акаунта.
| GET | Документація |
|---|---|
/trendnews/health | JSON |
/trendnews/countries | ISO-2 |
/trendnews/categories?country=UA | Фільтри й пагінація |
/trendnews/posts | Фільтри й пагінація |
/trendnews/posts/{id} | Публікації містять заголовок, дайджест, категорію, час публікації та посилання на першоджерела. Зберігайте зазначення джерел. |
/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'Фільтри й пагінація
Коди країн — ISO-2, дати — YYYY-MM-DD. limit: 1–100; offset: 0–1 000 000; top: 1–50. q: до 100 символів. Для категорій обов’язкова країна.
Публікації містять заголовок, дайджест, категорію, час публікації та посилання на першоджерела. Зберігайте зазначення джерел.
Постачальник: TrendNews. Придбані на dev.uk.app підписки діють тут. Вони не змінюють підписки або ключі на сайтах прямих продажів.
Квоти й оплата
Кожен API має власну квоту. Weather + IP працюють у чинному пакеті, TrendNews має окрему підписку.
Квоти Weather та IP оновлюються щомісяця за UTC. Квоти TrendNews — щодня о 00:00 UTC, зокрема за річної підписки. Перевищення блокується без автоматичних доплат.
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.
Джерела даних
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
Передавайте ключ у заголовку Authorization. Не додавайте його до URL та не публікуйте у фронтенд-коді.
