Global News by Country & Category

Global News by Country & Category with the finlight API

Markets are global, but most news APIs hand you an undifferentiated, English-only firehose. finlight lets you slice coverage along two dimensions, country and category, and read it in the language of the market you care about.

Filter by category

Every article is tagged with one or more of 13 categories:

markets, economy, business, politics, geopolitics, regulation, technology, energy, commodities, crypto, health, climate, security

Pass the ones you want in 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
  }'

Filter by country

Articles are also tagged with the countries they affect, using ISO 3166-1 alpha-2 codes (US, GB, DE, JP, and so on). Combine countries with categories to focus tightly:

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
  }'

This returns regulation stories affecting the US and UK. Country and category filters are AND-ed with everything else, so you can add tickers, a date range, or a query on top.

Read it in the local language

finlight covers news in 9 languages: English (en), Simplified Chinese (zh), Hindi (hi), Spanish (es), Japanese (ja), Korean (ko), Portuguese (pt), Arabic (ar), and Russian (ru). Set the language field to choose which language's coverage you get back (the default is 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)

That request returns Japanese-language markets and economy coverage for Japan, instead of forcing you through English-only reporting.

Why this matters

Combining country, category, and language lets you build genuinely regional views: German energy policy in German, Japanese market moves in Japanese, US regulation in English. For a global desk or a multi-region product, that is the difference between real local coverage and a translated approximation.

Where to go next

Get your free API key →

Monday, July 13, 2026

Global News by Country & Category with the finlight API