Old NewsCatcher News API V1
Number of APIs: 11
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 websitesnot_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 (skiing → ski, cats → cat, 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
-
Examples-/aggregation - Revolution on metioning SpaceX for the last month GET https://newscatcher.p.rapidapi.com/v1/aggregation?q=vaccin&agg_by=hour
-
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
-
Examples-/latest_headlines - Latest headlines in the US for business GET https://newscatcher.p.rapidapi.com/v1/latest_headlines?country=US&topic=business
-
Examples-/sources - Available french souces in english GET https://newscatcher.p.rapidapi.com/v1/sources?country=FR&lang=en
-
/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
-
/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
-
/v1/latest_headlines - /v1/latest_headlines Request Parameters GET https://newscatcher.p.rapidapi.com/v1/latest_headlines?lang=fr&country=FR&topic=politics
-
/v1/sources - /v1/sources Request Parameters GET https://newscatcher.p.rapidapi.com/v1/sources?lang=en&country=US&topic=politics
-
Examples-/search - Latest articles on nytimes.com GET https://newscatcher.p.rapidapi.com/v1/search?q=*&sort_by=date&sources=nytimes.com
-
/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