Getting Started
This guide walks you through subscribing to the Fast News Previews API on RapidAPI and making your first request.
1. Subscribe on RapidAPI
- Go to the Fast News Previews API page on RapidAPI.
- Choose a subscription plan (free tiers may be available).
- After subscribing, RapidAPI provides you with an API key (
x-rapidapi-key).
You will need two headers for every request:
| Header | Value | Where to Find It |
|---|---|---|
x-rapidapi-key | Your personal API key | RapidAPI dashboard, on the API page |
x-rapidapi-host | fast-news-with-previews.p.rapidapi.com | RapidAPI dashboard, on the API page |
When you use RapidAPI's test console, both headers are sent automatically.
2. Make Your First Request
Search for news about artificial intelligence in English:
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"
Replace YOUR_RAPIDAPI_KEY with the API key from your RapidAPI dashboard.
3. Read the Response
{
"topic": "artificial intelligence",
"geo": "all",
"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": "Bla bla bla this is a sample preview of what an article excerpt looks like in the response..."
}
]
}
Each article object contains:
| Field | Type | Description |
|---|---|---|
title | string | Article headline |
source | string | Source publication or website domain |
published_at | string | Publication timestamp in RFC 3339 format. Empty if the date could not be determined. |
url | string | Direct link to the original article |
image_url | string | URL to a thumbnail image, if available |
preview | string | Text excerpt (up to 250 characters). Falls back to the article title if no content preview is available. |
4. Explore More Endpoints
- Trending headlines:
GET /news/trending?language=en— get top headlines for any language - Topic categories:
GET /news/topic?topic1=technology&language=en— browse 11 predefined categories - Local news:
GET /news/local?query=Tokyo&language=en— find news about a specific area
See the Endpoints section for all available operations.
What's Next?
- Browse all endpoints for detailed parameter and response documentation
- Learn about authentication in detail
- Copy code examples in your preferred programming language
- Read about error handling to build resilient integrations