Skip to main content

GET /news/trending

Get localized trending headlines. Automatically translates the query into 40+ languages and supports regional variants.

All requests require RapidAPI authentication headers.

Quick Example

curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/trending?language=en" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

Parameters

ParameterTypeRequiredDefaultDescription
languagestringYes--Language code, e.g. en, es, de, ja (2-5 characters)
geostringNoallCountry/region code, e.g. US, GB, AR
limitintegerNo10Max articles to return (1-100)
timeframestringNoanytimeTime filter: last_1h, last_24h, last_48h, last_7d, last_30d, anytime

Response

Same article format as all news endpoints. The topic field is always empty (no user-specified topic).

More Examples

# German headlines for Austria
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/trending?language=de&geo=AT&limit=15" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

# Japanese headlines from the last 24 hours
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/trending?language=ja&timeframe=last_24h" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

Supported Languages

Some of the 40+ supported locales:

LanguageCodeTrending Query
English (US)en / en-US"top headlines"
English (UK)en-GB"top headlines UK"
Spanish (Spain)es / es-ES"titulares"
Spanish (Mexico)es-MX"titulares Mexico"
Germande / de-DE"aktuelle schlagzeilen"
Frenchfr / fr-FR"actualites"

Unsupported codes default to English ("top headlines").

Notes

  • When both language and geo are provided, they map to a locale-specific query (e.g., es + AR produces "titulares Argentina")

Errors

  • 400 — missing language
  • 503 — search backend temporarily unavailable