The official Python client library to manipulate NewsCatcher News API V2 from your Python application.
Documentation is identical with the API documentation. The same parameters and filters are available. And the same response structure. You can have a look at docs.newscatcherapi.com.
The Authentication is done via the x_api_key variable.
Receive your API key by registering at app.newscatcherapi.com.
pip install newscatcherapi
Import installed package.
from newscatcherapi import NewsCatcherApiClient
Init the instance with an API key given after registration.
newscatcherapi = NewsCatcherApiClient(x_api_key='YOUR_API_KEY')
An instance of NewsCatcherApiClient has three main methods that correspond to three endpoints available for NewsCatcher News API.
Main method that allows you to find news article by keyword, date, language, country, etc.
all_articles = newscatcherapi.get_search(q='Elon Musk',
lang='en',
countries='CA',
page_size=100)
It is the same method as get_search, but you can program to extract all articles without changing page param manually.
For example: for a given search you have 1000 found articles. get_search makes one API call and returns up to 100 articles. get_search_all_pages will make 10 API calls and will return all 1000 articles.
Two new parameters:
max_page - The last page number to extract. To use when you want to limit the number of extracted pages.seconds_pause - Number of seconds waiting before each call. This parameter helps you deal with the rate limit on your subscription plan. By default, it is set to 1 second.all_articles = newscatcherapi.get_search_all_pages(q='Elon Musk',
lang='en',
countries='CA',
page_size=100,
max_page=10,
seconds_pause=1.0
)
It is the same method as get_search, but you can fetch all articles without changing page, from_, and to_ params manually.
For example: for a given search you have found more than 10000 articles. get_search makes one API call and returns up to 100 articles.
get_search_all_pages will make 100 API calls and will return 10000 articles. The get_search_all_articles method will return all articles.
One new parameters:
by - How to divide the the time interval between to_ and from_ in order to extract all articles for the given search query. By default it is set to week. Accepted values: month, week, day, hour.
all_articles = newscatcherapi.get_search_all_articles(q='Elon Musk',
lang='en',
countries='CA',
page_size=100,
by = 'day'
)
Get the latest headlines given any topic, country, sources, or language.
top_headlines = newscatcherapi.get_latest_headlines(lang='en',
countries='us',
topic='business')
It is the same function as get_latest_headlines, but you can program to extract all articles without changing page param manually.
For example: for a given search you have 1000 found articles. get_latest_headlines makes one API call and returns up to 100 articles. get_latest_headlines_all_pages will make 10 API calls and will return all 1000 articles.
Two new parameters:
max_page - The last page number to extract. To use when you want to limit the number of extracted pages.seconds_pause - Number of seconds waiting before each call. This parameter helps you deal with the rate limit on your subscription plan. By default, it is set to 1 second.top_headlines = newscatcherapi.get_latest_headlines_all_pages(lang='en',
countries='us',
topic='business',
max_page=10,
seconds_pause=1.0
)
Returns a list of the top 100 supported news websites. Overall, we support over 60,000 websites. Using this method, you may find the top 100 for your specific language, country, topic combination.
sources = newscatcherapi.get_sources(topic='business',
lang='en',
countries='US')
If you want to use proxies, you can add this parameter to all the endpoints we have. Here is an example of a valid form proxies parameter and an example of using it with one of the endpoints.
proxies = {
'http': 'http://proxy.example.com:8080',
'https': 'http://secureproxy.example.com:8090',
}
all_articles = newscatcherapi.get_search(q='Elon Musk',
lang='en',
countries='CA',
page_size=100,
proxies=proxies)
In Python, we are not allowed to reserve variable names from and to. If you try to use them, you will get a syntax error:
SyntaxError: invalid syntax
So, here is an example on how to use time variables from_ and to_ in get_search method.
all_articles = newscatcherapi.get_search(q='Elon Musk',
lang='en',
countries='CA,US',
from_='2021/08/20',
to_='2021/08/31')
Feel free to contact us if you have spot a bug or have any suggestion at maksym[at]newscatcherapi.com
FAQs
NewsCatcher News API V2 SDK for Python
We found that newscatcherapi demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
npm now supports Trusted Publishing with OIDC, enabling secure package publishing directly from CI/CD workflows without relying on long-lived tokens.
Research
/Security News
A RubyGems malware campaign used 60 malicious packages posing as automation tools to steal credentials from social media and marketing tool users.
Security News
The CNA Scorecard ranks CVE issuers by data completeness, revealing major gaps in patch info and software identifiers across thousands of vulnerabilities.