Old NewsCatcher News API V1

Number of APIs: 11

NewcatcherAPI By developers, for developers

Get a key on RapidAPI (no credit card required)

Introduction

Newscatcher API is a JSON API that allows you to find news articles by topic, country, language, website, or keyword.

It is a right tool for you if you need to:

  • find all the news articles which mention any specific keyword(s) (/search endpoint)
  • know how many times any company, person, or event got mentioned per hour/day (/aggregation endpoint)
  • get the latest headlines for any country, or topic (/latest_headlines endpoint)
  • find all the articles that mention publicly traded company (in body or title of an article) (/stocks endpoint)

You can make a highly narrowed search by combining such filters as:

  • date & time an article got published
    • 2020-05-23 16:55
    • from yesterday 5pm EST to "now EST'
    • from 2020/05/30 4am to 2020/05/31 4am
    • from May 8 to May 18
    • from one week ago

We know how painful it is sometimes to work with dates, so we integrated dateparser Python package to take care of any date.

  • website (news publisher) of an article
    • sources=nytimes.com,wsj.com to search though a few specific websites
    • not_sources=rt.com,foxnews.com to exclude news websites from search
  • [experimental] filter news feed by a topic. Allowed topics are: news, sport, tech, world, finance, politics, business, economics, entertainment
  • [experimental] filter news feed by a country (e.g. US, FR, UA, etc)
  • language more about that below
  • many more

Important things to know:

  • on a usual day we get 170,000 - 200,000 articles
  • we daily update each website's rank
  • our database contains articles that were published since end April 2020
  • the default time is in UTC
  • we will never make any change that can impact your usage. New features and fixes will be released under a new API version

Our full-text search is aware of languages

We autodetect the language of each article. If it is one of the supported languages (en, fr, de, ru, es, it, tr, ar, sw, da), then it will be analyzed in accordance to each language's specifications.

For example, en model removes punctuation & stop words (and, the, a, etc). Then, it also lemmatizes all the words (skiingski, catscat, etc). This is only done for indexing, the text that we return you is left unchanged.

Each language is treated uniquely, so you can be sure that you will get the relevant results. Knowing the search language in advance can significantly boost the quality of Newscatcher's search engine.

Authentication

Get a key on RapidAPI (no credit card required)

Endpoints

/v1/search — highly customizable search through our database. All filters and sorting options are allowed.

/v1/search_free — a simple full-text search that you can try for free. Only the filtering per language is supported.

/v1/stocks — returns the news articles for any publicly traded company. Accepts only the ticker.

/v1/latest_headlines — always returns the latest 100 articles for any topic, country, language, or any of those combined

/v1/aggregation — searches as /v1/search but returns the articles count per hour or day instead of articles' data

/v1/sources — returns a list of supported news websites for any topic, country, language, or any of those combined

  1. Examples-/aggregation - Revolution on metioning SpaceX for the last month GET https://newscatcher.p.rapidapi.com/v1/aggregation?q=vaccin&agg_by=hour

  2. Examples-/stocks - Lastest Articles On A Company And Key People And Specific Sources GET https://newscatcher.p.rapidapi.com/v1/stocks?ticker=AAPL&key_people=True&sources=smarteranalyst.com,theedgemarkets.com

  3. Examples-/latest_headlines - Latest headlines in the US for business GET https://newscatcher.p.rapidapi.com/v1/latest_headlines?country=US&topic=business

  4. Examples-/sources - Available french souces in english GET https://newscatcher.p.rapidapi.com/v1/sources?country=FR&lang=en

  5. /v1/search - /v1/search Request Parameters GET https://newscatcher.p.rapidapi.com/v1/search?q=Trump&lang=en&from=2020/05/01&to=2020/06/01&search_in=title&country=US&topic=news&sources=nytimes.com,washingtontimes.com&not_sources=washingtonpost.com, buzzfeed.com&ranked_only=False&from_rank=1&to_rank=100000&sort_by=relevancy&page=2&page_size=75

  6. /v1/search_free - /v1/search_free Request Parameters GET https://newscatcher.p.rapidapi.com/v1/search_free?q=Trump&lang=en&ranked_only=True&page=1&page_size=25

  7. /v1/latest_headlines - /v1/latest_headlines Request Parameters GET https://newscatcher.p.rapidapi.com/v1/latest_headlines?lang=fr&country=FR&topic=politics

  8. /v1/sources - /v1/sources Request Parameters GET https://newscatcher.p.rapidapi.com/v1/sources?lang=en&country=US&topic=politics

  9. Examples-/search - Latest articles on nytimes.com GET https://newscatcher.p.rapidapi.com/v1/search?q=*&sort_by=date&sources=nytimes.com

  10. /v1/aggregation - /v1/aggregation Request Parameters GET https://newscatcher.p.rapidapi.com/v1/aggregation?q=Trump&lang=en&from=2020/05/01&to=2020/06/01&search_in=summary&country=US&topic=news&sources=cnn.com,usatoday.com&not_sources=buzzfeed.com&ranked_only=False&from_rank=1&to_rank=100000&agg_by=day