GET /news/advanced

Search for news with post-fetch filtering and sorting. Uses the same core search as /news, plus additional controls to include or exclude sources, require thumbnails, and change sort order.

All requests require RapidAPI authentication headers.

Quick Example

curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/advanced?topic=technology&language=en&source=bbc.com,reuters.com&thumbnail_only=true&sort=published_at_desc" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

Parameters

Parameter	Type	Required	Default	Description
topic	string	Yes	--	Search query, e.g. "artificial intelligence", "bitcoin price" (1-100 characters)
language	string	Yes	--	Language code, e.g. en, de, ja (2-5 characters)
geo	string	No	all	Country/region code for localized results, e.g. US, DE, JP
limit	integer	No	10	Max articles to return (1-100)
timeframe	string	No	anytime	Time filter: last_1h, last_24h, last_48h, last_7d, last_30d, anytime
source	string	No	--	Comma-separated domains to include, e.g. bbc.com,reuters.com (up to 500 chars)
exclude_source	string	No	--	Comma-separated domains to exclude (up to 500 chars)
thumbnail_only	boolean	No	--	Set to true to return only articles with thumbnails
sort	string	No	published_at_desc	Sort order: published_at_desc, published_at_asc, title_asc, title_desc

Filtering Behavior

Source and thumbnail filters are applied after fetching. This means:

• The limit controls how many articles are fetched from search, but the final count may be lower after filtering
• For example, limit=20 + thumbnail_only=true may return fewer than 20 if not enough results have thumbnails
• Restrictive source filters can significantly reduce results

Source matching supports subdomains. source=bbc.com matches www.bbc.com, news.bbc.com, and bbc.com.

exclude_source overrides source. If a domain appears in both lists, it is excluded.

Response

Same format as /news. See the response format in the overview.

More Examples

# Exclude low-quality sources
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/advanced?topic=politics&language=en&exclude_source=msn.com,aol.com" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

# Thumbnails only, sorted alphabetically
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/advanced?topic=space&language=en&thumbnail_only=true&sort=title_asc" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

# Combine source + thumbnail + sort + timeframe
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/advanced?topic=climate+change&language=en&source=bbc.com&thumbnail_only=true&sort=published_at_desc&timeframe=last_7d" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

Notes

• Default sort is newest-first (published_at_desc)
• Articles without dates are pushed to the end for date-based sorts
• Source diversity and deduplication work the same as /news
• Empty results after filtering return count: 0 with an empty items array

Errors

• 400 — missing topic/language, invalid sort or timeframe value
• 401 — missing authentication headers
• 503 — search backend temporarily unavailable