GET /news

Search for news articles by topic. Provide any query and receive a list of matching articles from diverse sources.

All requests require RapidAPI authentication headers.

Quick Example

curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news?topic=artificial+intelligence&language=en" \
  -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

Response

200 OK

{
  "topic": "artificial intelligence",
  "geo": "us",
  "language": "en",
  "count": 10,
  "items": [
    {
      "title": "Made-up article about AI",
      "source": "example-news.com",
      "published_at": "2026-04-16T10:30:00Z",
      "url": "https://example-news.com/articles/ai-update",
      "image_url": "https://cdn.example-news.com/thumb.jpg",
      "preview": "A short excerpt from the article body..."
    }
  ]
}

Envelope fields: topic (searched topic), geo (geographic filter), language, count (number of articles), items (article array).

Article fields are the same across all endpoints — see the response format in the overview.

More Examples

# With geo targeting and custom limit
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news?topic=bitcoin&language=en&geo=US&limit=20" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

# With timeframe filter
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news?topic=climate+change&language=en&timeframe=last_7d" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  -H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"

Behavior

• Source diversity — no more than 25% of articles come from the same domain
• Deduplication — near-identical titles are merged; non-MSN sources are preferred
• Timeframe filtering — articles without a published_at date are excluded when a specific timeframe is set
• Preview length — capped at 250 characters; follow url for the full article
• Paywalls — the API cannot bypass paywalled content

Errors

Returns standard error format (see error handling). Common responses for this endpoint:

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