Monday, July 13, 2026

Глобальные новости по стране и категории через finlight API

Kevin Bartsch

Глобальные новости по стране и категории через 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)

Этот запрос вернёт японоязычное освещение рынков и экономики по Японии, а не вынудит вас читать материалы только на английском.

Почему это важно

Сочетание страны, категории и языка позволяет строить по-настоящему региональные срезы: энергополитику Германии на немецком, движения японского рынка на японском, регулирование США на английском. Для глобального деска или мультирегионального продукта это и есть разница между настоящим местным освещением и переведённым приближением.

Что дальше

Получите бесплатный API-ключ →