Monday, July 13, 2026
Notícias Globais por País e Categoria com a API da finlight
Notícias Globais por País e Categoria com a API da finlight
Os mercados são globais, mas a maioria das APIs de notícias entrega uma enxurrada indiferenciada e apenas em inglês. A finlight permite segmentar a cobertura em duas dimensões, país e categoria, e lê-la no idioma do mercado que importa para você.
Filtrar por categoria
Cada artigo é marcado com uma ou mais das 13 categorias:
markets, economy, business, politics, geopolitics, regulation, technology, energy,
commodities, crypto, health, climate, security
Passe as que você quer em 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
}'
Filtrar por país
Os artigos também são marcados com os países que afetam, usando códigos ISO 3166-1 alpha-2 (US,
GB, DE, JP e assim por diante). Combine countries com categories para focar de forma precisa:
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
}'
Isso retorna matérias de regulação que afetam os EUA e o Reino Unido. Os filtros de país e categoria
são combinados com tudo o mais por AND, então você pode adicionar tickers, um intervalo de datas ou
uma query por cima.
Leia no idioma local
A finlight cobre notícias em 9 idiomas: inglês (en), chinês simplificado (zh), híndi (hi),
espanhol (es), japonês (ja), coreano (ko), português (pt), árabe (ar) e russo (ru). Defina
o campo language para escolher em qual idioma você recebe a cobertura (o padrão é 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)
Essa requisição retorna a cobertura de mercados e economia do Japão em japonês, em vez de forçar você a passar por reportagens apenas em inglês.
Por que isso importa
Combinar país, categoria e idioma permite construir visões realmente regionais: política energética alemã em alemão, movimentos do mercado japonês em japonês, regulação dos EUA em inglês. Para uma mesa global ou um produto multirregional, essa é a diferença entre cobertura local de verdade e uma aproximação traduzida.
