Skip to main content

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

HeaderValueRequired
x-rapidapi-keyYour RapidAPI API keyYes
x-rapidapi-hostfast-news-with-previews.p.rapidapi.comYes

Query Parameters

ParameterTypeRequiredDefaultConstraintsDescription
querystringYes--1-100 charactersArea, city, or region name (e.g., "Tokyo", "New York", "Scotland")
languagestringNoen2-5 charactersLanguage code
geostringNo--2-5 charactersCountry/region code for additional localization
limitintegerNo201-100Maximum number of articles to return
timeframestringNoanytimeSee values belowTime 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..."
}
]
}
FieldTypeDescription
topicstringAlways empty for local news
geostringGeographic filter applied
languagestringLanguage used for the search
countintegerNumber of articles returned
itemsarrayArray 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=Tokyo searches for "Tokyo local news"). You do not need to include "local news" yourself.
  • The default limit is 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 query parameter with a matching geo code (e.g., query=Munich&geo=DE).
  • See the news endpoint documentation for article object field descriptions.