GET /news/trending

Get localized trending headlines. This endpoint automatically translates the "top headlines" query into 40+ languages and supports regional variants (e.g., "titulares Argentina" for Spanish in Argentina).

Request

URL

GET /news/trending

Headers

Header	Value	Required
x-rapidapi-key	Your RapidAPI API key	Yes
x-rapidapi-host	fast-news-with-previews.p.rapidapi.com	Yes

Query Parameters

Parameter	Type	Required	Default	Constraints	Description
language	string	Yes	--	2-5 characters	Language code (e.g., en, es, de, ja)
geo	string	No	--	2-5 characters	Country/region code (e.g., US, GB, AR)
limit	integer	No	10	1-100	Maximum number of articles to return
timeframe	string	No	anytime	See values below	Time filter for article recency

Accepted timeframe values: last_1h, last_24h, last_48h, last_7d, last_30d, anytime

Example Requests

# English trending headlines
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"

# German trending headlines with region
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 trending 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"

Response

200 OK

{
  "topic": "",
  "geo": "all",
  "language": "en",
  "count": 10,
  "items": [
    {
      "title": "Made-up trending headline",
      "source": "example-news.com",
      "published_at": "2026-04-16T09:00:00Z",
      "url": "https://example-news.com/articles/trending",
      "image_url": "https://cdn.example-news.com/thumb.jpg",
      "preview": "Bla bla bla this is a sample preview of what a trending article excerpt looks like..."
    }
  ]
}

Field	Type	Description
topic	string	Always empty for trending (no user-specified topic)
geo	string	Geographic filter applied (omitted if not specified)
language	string	Language used for the search
count	integer	Number of articles returned
items	array	Array of article objects (same structure as /news)

Error Responses

400 Bad Request — missing language

{
  "detail": "Key: 'TrendingRequest.Language' Error:Field validation for 'Language' failed on the 'required' tag"
}

503 Service Unavailable

{
  "detail": "News service temporarily unavailable"
}

Supported Languages

The trending endpoint supports localized queries for 40+ languages. Some examples:

Language	Code	Trending 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"
German	de / de-DE	"aktuelle schlagzeilen"
French	fr / fr-FR	"actualites"
Japanese	ja / ja-JP	"top headline"
Korean	ko / ko-KR	"headline"
Chinese (Simplified)	zh / zh-CN	Headline news
Arabic	ar	"Headlines of news"

For unsupported language codes, the query defaults to English ("top headlines").

Notes

• The topic field in the response is always empty since trending headlines are not tied to a user-specified topic.
• When both language and geo are provided, the API maps them to a locale-specific query (e.g., language=es + geo=AR produces "titulares Argentina").
• See the news endpoint documentation for article object field descriptions.