finlight Logo

Monday, July 13, 2026

Notícias Globais por País e Categoria com a API da finlight

Kevin Bartsch

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.

Para onde ir agora

Obtenha sua chave de API gratuita →