finlight Logo

Monday, July 13, 2026

按国家与分类获取全球新闻(finlight API)

Kevin Bartsch

按国家与分类获取全球新闻(finlight API)

市场是全球化的,但大多数新闻 API 只会丢给你一股不加区分、且只有英语的信息洪流。finlight 让你可以沿两个 维度——国家和分类——切分报道,并用你关心的那个市场的语言来阅读它。

按分类过滤

每篇文章都会被标注为 13 个分类中的一个或多个:

marketseconomybusinesspoliticsgeopoliticsregulationtechnologyenergycommoditiescryptohealthclimatesecurity

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 代码(USGBDEJP 等)。把 countriescategories 结合起来,可以精准聚焦:

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 密钥 →