Monday, July 13, 2026
Глобальные новости по стране и категории через finlight API
Глобальные новости по стране и категории через finlight API
Рынки глобальны, но большинство новостных API выдают вам недифференцированный поток только на английском. finlight позволяет нарезать освещение по двум измерениям — стране и категории — и читать его на языке того рынка, который вам важен.
Фильтрация по категории
Каждая статья помечена одной или несколькими из 13 категорий:
markets, economy, business, politics, geopolitics, regulation, technology, energy,
commodities, crypto, health, climate, security
Передайте нужные в поле categories:
curl -X POST https://api.finlight.me/v2/articles \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"categories": ["technology", "crypto"],
"pageSize": 20
}'
Фильтрация по стране
Статьи также помечаются странами, которых они касаются, по кодам ISO 3166-1 alpha-2 (US, GB, DE,
JP и так далее). Сочетайте countries с categories, чтобы сфокусироваться точнее:
curl -X POST https://api.finlight.me/v2/articles \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"countries": ["US", "GB"],
"categories": ["regulation"],
"pageSize": 20
}'
Это вернёт материалы о регулировании, затрагивающие США и Великобританию. Фильтры по стране и категории
объединяются со всем остальным через AND, так что поверх можно добавить tickers, диапазон дат или
query.
Читайте на местном языке
finlight охватывает новости на 9 языках: английском (en), упрощённом китайском (zh), хинди (hi),
испанском (es), японском (ja), корейском (ko), португальском (pt), арабском (ar) и русском
(ru). Задайте поле language, чтобы выбрать, на каком языке получать освещение (по умолчанию en):
# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams
client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))
params = GetArticlesParams(
countries=["JP"],
categories=["markets", "economy"],
language="ja",
pageSize=20,
)
response = client.articles.fetch_articles(params)
Этот запрос вернёт японоязычное освещение рынков и экономики по Японии, а не вынудит вас читать материалы только на английском.
Почему это важно
Сочетание страны, категории и языка позволяет строить по-настоящему региональные срезы: энергополитику Германии на немецком, движения японского рынка на японском, регулирование США на английском. Для глобального деска или мультирегионального продукта это и есть разница между настоящим местным освещением и переведённым приближением.
