Market news API for Brazil, India, Europe and Asia-Pacific

Every article in the H1 News API carries a region (the geography its source covers) and a language (ISO-639-1). Both are filters on /v1/news, on every category endpoint and on the stream, and both take lists. That is the whole feature; the rest of this page is what it gets you.

Brazil

curl -H 'X-API-Key: YOUR_KEY' 'https://api.heliusone.com/v1/news?region=br&limit=5'

{"title": "Ibovespa fecha em alta com Petrobras e bancos; dólar recua",
 "language": "pt", "region": "br", "tickers": ["PBR"], "sentiment": {"label": "positive", "score": 0.61}}
{"title": "Botswana Diamond Production Rises After Two Lost Years",
 "language": "en", "region": "br", "tickers": [], "sentiment": {"label": "positive", "score": 0.44}}

Seven Brazilian outlets — the leading financial dailies and market sites in Portuguese, plus two English-language editions and the state news agency. Add language=pt to keep only the local-language press, or language=en for the English editions. US-listed names tag with their ADR symbols — Petrobras as PBR, Vale as VALE, Itaú as ITUB.

India, China, Japan, Southeast Asia, Australia

# India — the leading business dailies, the Reserve Bank of India, and a Google News India edition
curl -H 'X-API-Key: YOUR_KEY' 'https://api.heliusone.com/v1/news?region=in&language=en&date=today'

The Asia-Pacific regions are in (India's leading business dailies, the Reserve Bank of India, and Google News's India edition), cn (Hong Kong's English-language business and China-economy desks plus the Hong Kong edition), jp (Japan's English-language business press and the Bank of Japan), asia (Singapore and the Philippines) and au (Australia's national business press and the Reserve Bank of Australia). Combine them: region=in,cn,jp,asia,au.

Europe and the UK

# Europe in English only; drop language= to include the German, French, Italian, Spanish and Dutch business press
curl -H 'X-API-Key: YOUR_KEY' 'https://api.heliusone.com/v1/news?region=eu&language=en&category=macro'

eu carries the ECB and the European Commission, English-language European business coverage, and the leading financial press of Germany, France, Italy, Spain and the Netherlands in their own languages, plus Ireland's. uk is the Bank of England, the FCA, the ONS release calendar and the UK financial press.

Latin America as one market

# Whole of Latin America, Spanish and Portuguese, market news only
curl -H 'X-API-Key: YOUR_KEY' 'https://api.heliusone.com/v1/news?region=br,mx,latam&language=es,pt&category=markets'

mx is Mexico's leading financial outlets in Spanish plus an English-language daily; latam is region-wide coverage and the financial press of Argentina and Peru.

See exactly what you are reading

# The feed list, with per-source counts and region — your key sees the exact names
curl -H 'X-API-Key: YOUR_KEY' 'https://api.heliusone.com/v1/sources?active_only=true'

Every name in that list is a valid source= or exclude_source= value, and every article carries its source, so you can audit, prefer or drop any outlet from your own code.

On the stream

wss://api.heliusone.com/v1/stream?api_key=YOUR_KEY&regions=in,cn,jp,asia&languages=en

The stream takes the same regions and languages lists. The HeliusOne terminal uses exactly this to offer "US + global wires", "Latin America" and "Asia-Pacific" presets to its users.

In Python

from h1news import H1News
news = H1News("sk_...")

# Petrobras coverage from the Brazilian press — ADR ticker, local outlets
pbr = news.news("PBR", region="br", date="last7days")
for a in pbr["results"]:
    print(a["language"], a["source"], a["title"])

Global and the wires

region=global is the international layer — the global news agencies' headlines, the international financial dailies, world broadcasters, and the commodities, forex and crypto feeds. The terminal's default of region=us,global is a good starting point for a US book; add your market's code on top.