GET /news/local
Get news specific to a geographic area, city, or region. The API appends "local news" to your query to focus results on local sources.
Request
URL
GET /news/local
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 |
|---|---|---|---|---|---|
query | string | Yes | -- | 1-100 characters | Area, city, or region name (e.g., "Tokyo", "New York", "Scotland") |
language | string | No | en | 2-5 characters | Language code |
geo | string | No | -- | 2-5 characters | Country/region code for additional localization |
limit | integer | No | 20 | 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
# Local news for Tokyo
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/local?query=Tokyo&language=en" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"
# Local news with geo and timeframe
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/local?query=Berlin&language=de&geo=DE&timeframe=last_7d" \
-H "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
-H "x-rapidapi-host: fast-news-with-previews.p.rapidapi.com"
# Local news for a US city
curl -X GET "https://fast-news-with-previews.p.rapidapi.com/news/local?query=Austin+Texas&language=en&limit=15" \
-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": 20,
"items": [
{
"title": "Made-up article about local news",
"source": "example-news.com",
"published_at": "2026-04-16T07:00:00Z",
"url": "https://example-news.com/articles/local-news",
"image_url": "https://cdn.example-news.com/thumb.jpg",
"preview": "Bla bla bla this is a sample preview of what a local news article excerpt looks like..."
}
]
}
| Field | Type | Description |
|---|---|---|
topic | string | Always empty for local news |
geo | string | Geographic filter applied |
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 query
{
"detail": "Key: 'LocalRequest.Query' Error:Field validation for 'Query' failed on the 'required' tag"
}
503 Service Unavailable
{
"detail": "News service temporarily unavailable"
}
Notes
- The API automatically appends "local news" to your query string (e.g.,
query=Tokyosearches for "Tokyo local news"). You do not need to include "local news" yourself. - The default
limitis 20 (higher than the default on /news). - Results may include news from nearby areas, not just the exact location specified.
- For best results, combine the
queryparameter with a matchinggeocode (e.g.,query=Munich&geo=DE). - See the news endpoint documentation for article object field descriptions.