Introduction to Local News API
Local News API features and capabilities
What is Local News API?
Local News API provides precise access to location-specific news content worldwide. Building upon News API v3’s robust foundation, it adds specialized features for geographic news discovery and analysis. Whether developing local news applications, analyzing regional trends, or tracking city-specific coverage, Local News API helps you efficiently work with geographically focused news data.
Key features
- AI-powered location recognition and validation
- Advanced querying with boolean operators and proximity search
- Multiple town association methods for precise location matching
- NLP-enriched content for deeper analysis
- Articles clustering
- Multi-language support
- High volume data retrieval (up to 1000 articles per request)
Available plans
Local News API offers three subscription tiers, each with specific capabilities:
Plan | API Calls | Rate Limit | Historical Data | Key Capabilities |
---|---|---|---|---|
Standard NLP | 250,000/month | 5/second | 30 days | NLP analysis, clustering, town association |
NLP with Embeddings | 25,000/month | 5/second | 30 days | Standard NLP features + text embeddings |
AI Extraction NLP | 250,000/month | 5/second | 30 days | Standard NLP features + AI town extraction and validation |
All plans include comprehensive NLP capabilities and support up to 2000 sources per request. For detailed information about, visit the Subscription plans page.
Base URL
You must send all the API requests to the following base URL:
Endpoints
Endpoint | Method | Description | Use Case |
---|---|---|---|
/api/search | POST | Full-text search with location filtering | Find articles matching specific criteria for given locations |
/api/latest_headlines | POST | Recent articles by location | Monitor latest news for specific towns or regions |
/api/search_by | POST | Direct article lookup | Retrieve specific articles using URLs, IDs, or RSS GUIDs |
/api/sources | POST | Available news sources | Discover local news providers by region |
Request Format
Include your API key in the x-api-token
header for each request. All requests
must use HTTPS.
Response format
All API responses are JSON objects containing articles and metadata. The key response fields include:
The status of the request.
The total number of articles matching the query.
The current page number.
The total number of available pages.
The number of articles per page.
An array of article objects, each containing location-specific metadata and content.
The parameters used in your request for verification and debugging.
For detailed descriptions of all available response fields, refer to the specific endpoint documentation in the Endpoints section.
Example request
Here’s a sample search for venture capital news in San Francisco:
Example response
Getting started
To start using Local News API:
- Contact our sales team to discuss your needs and obtain an API key.
- Once you have your API key, check out our Quickstart guide to make your first API call.
- Explore Documentation to unlock the full potential of the API.
For detailed information about request parameters and response formats, refer to the specific endpoint documentation in this API reference.
The Local News API is your gateway to precise, location-specific news content. Whether you’re building local news applications, analyzing regional trends, or tracking city-specific coverage, we’re here to help you navigate the world of local news data.
Was this page helpful?