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)

Base URL

You must send all the API requests to the following base URL:

https://local-news.newscatcherapi.com

Endpoints

EndpointMethodDescriptionUse Case
/api/searchPOSTFull-text search with location filteringFind articles matching specific criteria for given locations
/api/latest_headlinesPOSTRecent articles by locationMonitor latest news for specific towns or regions
/api/search_byPOSTDirect article lookupRetrieve specific articles using URLs, IDs, or RSS GUIDs
/api/sourcesPOSTAvailable news sourcesDiscover 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:

status
string

The status of the request.

total_hits
integer

The total number of articles matching the query.

page
integer

The current page number.

total_pages
integer

The total number of available pages.

page_size
integer

The number of articles per page.

articles
array

An array of article objects, each containing location-specific metadata and content.

user_input
object

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:

Request
{
  "q": "venture capital",
  "associated_towns": [
    {
      "name": "San Francisco, California"
    }
  ],
  "lang": "en",
  "from_": "7 days ago"
}

Example response

Response
{
  "status": "ok",
  "total_hits": 5,
  "page": 1,
  "total_pages": 1,
  "page_size": 100,
  "articles": [
    {
      "id": "dabf25a5cbee2705f1ab866eeafdc835",
      "associated_town": [
        {
          "ai_validated": true,
          "name": "San Francisco, California",
          "description": ["HYPERLOCAL_SOURCES_INCLUDE_QUERY"]
        }
      ],
      "ai_associated_town": null,
      "score": 17.720953,
      "title": "Tech company to move headquarters from San Francisco to Texas",
      "author": "Aayush Gupta",
      "link": "https://www.bizjournals.com/sanfrancisco/news/2024/10/24/simplilearn-kumar-plano-san-francisco-headquarters.html",
      "description": "The company offers a variety of online training programs for those interested in working in the tech industry, including programming, cybersecurity, digital marketing and artificial intelligence.",
      "media": "https://media.bizj.us/view/img/11514132/042712369*1200xx5184-2916-0-270.jpg",
      "content": "A global digital education company is relocating its U.S headquarters from downtown San Francisco to North Texas...",
      "authors": ["Aayush Gupta"],
      "published_date_precision": "full",
      "published_date": "2024-10-24 18:40:00",
      "updated_date": null,
      "updated_date_precision": null,
      "is_opinion": false,
      "twitter_account": null,
      "domain_url": "bizjournals.com",
      "parent_url": "https://www.bizjournals.com/sanfrancisco",
      "word_count": 391,
      "rank": 503,
      "country": "US",
      "rights": "bizjournals.com",
      "language": "en",
      "nlp": {
        "theme": ["Business", "Tech"],
        "summary": "Simplilearn Solutions Pvt. Ltd. is relocating its U.S headquarters from downtown San Francisco to Plano, Texas. The new HQ will be located at 5851 Legacy Circle in Legacy Town Center.",
        "sentiment": {
          "title": 0.0,
          "content": 0.9911
        },
        "ner_PER": [
          {
            "entity_name": "Krishna Kumar",
            "count": 1
          }
        ],
        "ner_ORG": [
          {
            "entity_name": "Simplilearn",
            "count": 4
          }
        ],
        "ner_MISC": [
          {
            "entity_name": "NYSE",
            "count": 1
          }
        ],
        "ner_LOC": [
          {
            "entity_name": "San Francisco",
            "count": 2
          },
          {
            "entity_name": "Texas",
            "count": 1
          }
        ]
      },
      "paid_content": false
    }
    // ... other articles
  ],
  "user_input": {
    "q": "venture capital",
    "associated_towns": [
      {
        "name": "San Francisco, California"
      }
    ],
    "lang": "en",
    "from_": "7 days ago"
  }
}

Getting started

To start using Local News API:

  1. Contact our sales team to discuss your needs and obtain an API key.
  2. Once you have your API key, check out our Quickstart guide to make your first API call.
  3. 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.