How Do I Filter News by Language? Multi-Language News API for International Coverage
This guide shows how to use our multilingual news API to filter international news by language.
Access to only English-language news is limiting. Many important stories originate in non‑English markets first, and translations can lag or lose nuance. To build truly global experiences, applications should source articles directly from international publishers in their original languages and let readers filter by the languages they prefer.
Why include international sources?
Section titled “Why include international sources?”-
Broader coverage and earlier signals
Local outlets often break stories before they appear in English-language media.
-
Access for readers who don’t use English
Providing content in a reader’s preferred language increases inclusion and engagement.
-
Reduced translation bias and richer context
Reading reporting at the source preserves local nuance, terminology, and culturally specific details that can be lost in translation.
Languages we support
Section titled “Languages we support”We provide access to articles in English, German, Spanish, French, Portuguese and more. The catalog continues to expand. For the latest list of supported languages, please refer to our official documentation: Supported languages.
How to filter by language
Section titled “How to filter by language”Use the language parameter (2‑letter ISO code) to retrieve articles in a specific language.
JavaScript: Spanish (es)
Section titled “JavaScript: Spanish (es)”fetch('https://api.newsdatahub.com/v1/news?language=es', { headers: { 'X-API-Key': 'your_api_key_here', 'User-Agent': 'newsdatahub-multilingual-support/1.0-js' }}) .then(response => response.json()) .then(data => { console.log(`Found ${data.total_results} articles`); console.log(data.data); // Array of articles });JavaScript: French (fr)
Section titled “JavaScript: French (fr)”fetch('https://api.newsdatahub.com/v1/news?language=fr', { headers: { 'X-API-Key': 'your_api_key_here', 'User-Agent': 'newsdatahub-multilingual-support/1.0-js' }}) .then(response => response.json()) .then(data => { console.log(`Found ${data.total_results} articles`); console.log(data.data); // Array of articles });curl: Spanish (es)
Section titled “curl: Spanish (es)”curl -H "X-API-Key: your_api_key_here" \ -H "User-Agent: newsdatahub-multilingual-support/1.0-curl" \ "https://api.newsdatahub.com/v1/news?language=es"curl: French (fr)
Section titled “curl: French (fr)”curl -H "X-API-Key: your_api_key_here" \ -H "User-Agent: newsdatahub-multilingual-support/1.0-curl" \ "https://api.newsdatahub.com/v1/news?language=fr"Python: Spanish (es)
Section titled “Python: Spanish (es)”import requests
headers = { "X-API-Key": "your_api_key_here", "User-Agent": "newsdatahub-multilingual-support/1.0-py"}
# Spanishresp_es = requests.get("https://api.newsdatahub.com/v1/news?language=es", headers=headers)print("Found", resp_es.json().get("total_results"))print(resp_es.json().get("data"))Python: French (fr)
Section titled “Python: French (fr)”import requests
headers = { "X-API-Key": "your_api_key_here", "User-Agent": "newsdatahub-multilingual-support/1.0-py"}
# Frenchresp_fr = requests.get("https://api.newsdatahub.com/v1/news?language=fr", headers=headers)print("Found", resp_fr.json().get("total_results"))print(resp_fr.json().get("data"))Combine filters (language + country + topic)
Section titled “Combine filters (language + country + topic)”// Example: Spanish articles from Mexico about politicsconst url = 'https://api.newsdatahub.com/v1/news?language=es&country=mx&topic=politics';
fetch(url, { headers: { 'X-API-Key': 'your_api_key_here', 'User-Agent': 'newsdatahub-multilingual-support/1.0-js' }}) .then(response => response.json()) .then(data => { console.log(`Found ${data.total_results} articles`); console.log(data.data); // Array of articles });Use cases for a multilingual news API
Section titled “Use cases for a multilingual news API”- Market and risk monitoring in non‑English regions
- Alerts and dashboards tailored to local audiences
- Early‑signal detection before English syndication
-
Which languages are supported?
We currently provide access to English, German, Spanish, French, Portuguese, and more. See the official docs for the latest list.
-
Are articles translated or original?
Articles are provided in their original language.
-
Can I combine language with country or topic filters?
Yes. Combine
languagewith parameters likecountryandtopicas shown above. -
How do I authenticate?
Include your API key in the
X-API-Keyheader as shown in the examples. See our docs on how to authenticate: Authentication
Summary
Section titled “Summary”Relying only on English‑language articles narrows perspective. By sourcing from international publishers and filtering by language, you deliver broader coverage, include non‑English readers, and preserve the nuance of local reporting. For the most current list of supported languages, see the official documentation: NewsDataHub Docs.
Continue Your API Journey
Section titled “Continue Your API Journey”Ready to learn more?
- Country-Specific News with NewsDataHub: Filter Headlines by Country - Learn how to filter news by country using ISO codes, combine multiple countries, and integrate country filtering with other parameters for precise results.
- Related Articles Endpoint — GET
/v1/news/{article_id}/related- Find similar articles to any story to help users explore connected coverage and deepen context. - Filter News by Political Leaning - Focus results by publisher alignment to discover viewpoints from all sides and build balanced feeds.