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)
这个请求会返回关于日本的、日语的市场与经济类报道,而不必让你迁就只有英语的报道。
这为何重要
把国家、分类和语言结合起来,你就能构建真正的区域化视图:用德语看德国能源政策,用日语看日本市场动向, 用英语看美国监管。对于一个全球团队或一个多地区产品而言,这正是“真正的本地报道”与“翻译近似”之间的 区别。
