If Google News had a Python library
Created by Artem from newscatcherapi.com but you do not need anything from us or from anyone else to get the software going, it just works out of the box.
My blog post about how I did it
You might also like to check our Google News API or Financial Google News API
A python wrapper of the Google News RSS feed.
Top stories, topic related news feeds, geolocation news feed, and an extensive full text search feed.
This work is more of a collection of all things I could find out about how Google News functions.
from_ & to_), latest published (when)Before we start, if you want to integrate Google News data to your production then I would advise you to use one of the 3 methods described below. Why? Because you do not want your servers IP address to be locked by Google. Every time you call any function there is an HTTPS request to Google's servers. Don't get me wrong, this Python package still works out of the box.
scraping_bee parameter where you paste your API key. You can also try it for free, no credit card required. See exampleproxies parameter (python dictionary) where you just paste your own proxies.I love working with the news data. I love it so much that I created my own company that crawls for hundreds of thousands of news articles, and allow you to search it via a news API. But this time, I want to share with the community a Python package that makes it simple to get the news data from the best search engine ever created - Google.
Most likely, you know already that Google has its own news service. It is different from the usual Google search that we use on a daily basis (sorry DuckDuckGo, maybe next time).
This package uses the RSS feed of the Google News. The top stories page, for example.
RSS is an XML page that is already well structured. I heavily rely on Feedparser package to parse the RSS feed.
Google News used to have an API but it was deprecated many years ago. (Unofficial) information about RSS syntax is decentralized over the web. There is no official documentation. So, I tried my best to collect all this informaion in one place.
$ pip install pygooglenews --upgrade
from pygooglenews import GoogleNews
gn = GoogleNews()
top = gn.top_news()
business = gn.topic_headlines('business')
headquaters = gn.geo_headlines('San Fran')
# search for the best matching articles that mention MSFT and
# do not mention AAPL (over the past 6 month
search = gn.search('MSFT -APPL', when = '6m')
from pygooglenews import GoogleNews
# default GoogleNews instance
gn = GoogleNews(lang = 'en', country = 'US')
To get the access to all the functions, you first have to initiate the GoogleNews class.
It has 2 required variables: lang and country
You can try any combination of those 2, however, it does not exist for all. Only the combinations that are supported by GoogleNews will work. Check the official Google News page to check what is covered:
On the bottom left side of the Google News page you may find a Language & region section where you can find all of the supported combinations.
For example, for country=UA (Ukraine), there are 2 languages supported:
lang=uk Ukrainianlang=ru Russiantop = gn.top_news(proxies=None, scraping_bee = None)
top_news() returns the top stories for the selected country and language that are defined in GoogleNews class. The returned object contains feed (FeedParserDict) and entries list of articles found with all data parsed.
business = gn.topic_headlines('BUSINESS', proxies=None, scraping_bee = None)
The returned object contains feed (FeedParserDict) and entries list of articles found with all data parsed.
Accepted topics are:
WORLDNATIONBUSINESSTECHNOLOGYENTERTAINMENTSCIENCESPORTSHEALTHHowever, you can find some other topics that are also supported by Google News.
For example, if you search for corona in the search tab of en + US you will find COVID-19 as a topic.
The URL looks like this: https://news.google.com/topics/CAAqIggKIhxDQkFTRHdvSkwyMHZNREZqY0hsNUVnSmxiaWdBUAE?hl=en-US&gl=US&ceid=US%3Aen
We have to copy the text after topics/ and before ?, then you can use it as an input for the top_news() function.
from pygooglenews import GoogleNews
gn = GoogleNews()
covid = gn.topic_headlines('CAAqIggKIhxDQkFTRHdvSkwyMHZNREZqY0hsNUVnSmxiaWdBUAE')
However, be aware that this topic will be unique for each language/country combination.
gn = GoogleNews('uk', 'UA')
kyiv = gn.geo_headlines('kyiv', proxies=None, scraping_bee = None)
# or
kyiv = gn.geo_headlines('kiev', proxies=None, scraping_bee = None)
# or
kyiv = gn.geo_headlines('киев', proxies=None, scraping_bee = None)
# or
kyiv = gn.geo_headlines('Київ', proxies=None, scraping_bee = None)
The returned object contains feed (FeedParserDict) and entries list of articles found with all data parsed.
All of the above variations will return the same feed of the latest news about Kyiv, Ukraine:
geo['feed'].title
# 'Київ - Останні - Google Новини'
It is language agnostic, however, it does not guarantee that the feed for any specific place will exist. For example, if you want to find the feed on LA or Los Angeles you can do it with GoogleNews('en', 'US').
The main (en, US) Google News client will most likely find the feed about the most places.
gn.search(query: str, helper = True, when = None, from_ = None, to_ = None, proxies=None, scraping_bee=None)
The returned object contains feed (FeedParserDict) and entries list of articles found with all data parsed.
Google News search itself is a complex function that has inherited some features from the standard Google Search.
The official reference on what could be inserted
The biggest obstacle that you might have is to write the URL-escaping input. To ease this process, helper = True is turned on by default.
helper uses urllib.parse.quote_plus to automatically convert the input.
For example:
'New York metro opening' --> 'New+York+metro+opening''AAPL -MSFT' --> 'AAPL+-MSFT''"Tokyo Olimpics date changes"' --> '%22Tokyo+Olimpics+date+changes%22'You can turn it off and write your own query in case you need it by helper = False
when parameter (str) sets the time range for the published datetime. I could not find any documentation regarding this option, but here is what I deducted:
h for hours.(For me, worked for up to 101h). when=12h will search for only the articles matching the search criteri and published for the last 12 hoursd for daysm for month (For me, worked for up to 48m)I did not set any hard limit here. You may try put here anything. Probably, it will work. However, I would like to warn you that wrong inputs will not lead to an error. Instead, the when parameter will be ignored by the Google.
from_ and to_ accept the following format of date: %Y-%m-%d For example, 2020-07-01
Google's Special Query Terms Cheat Sheet
Many Google's Special Query Terms have been tested one by one. Most of the core ones have been inherited by Google News service. At first, I wanted to integrate all of those as the search() function parameters. But, I realised that it might be a bit confusing and difficult to make them all work correctly.
Instead, I decided to write some kind of a cheat sheet that should give you a decent understanding of what you could do.
from pygooglenews import GoogleNews
gn = GoogleNews()
s = gn.search('boeing OR airbus')
print(s['feed'].title)
# "boeing OR airbus" - Google News
"The exclude (-) query term restricts results for a particular search request to documents that do not contain a particular word or phrase. To use the exclude query term, you would preface the word or phrase to be excluded from the matching documents with "-" (a minus sign)."
"The include (+) query term specifies that a word or phrase must occur in all documents included in the search results. To use the include query term, you would preface the word or phrase that must be included in all search results with "+" (a plus sign).
The URL-escaped version of + (a plus sign) is %2B."
"The phrase search (") query term allows you to search for complete phrases by enclosing the phrases in quotation marks or by connecting them with hyphens.
The URL-escaped version of " (a quotation mark) is %22.
Phrase searches are particularly useful if you are searching for famous quotes or proper names."
"The allintext: query term requires each document in the search results to contain all of the words in the search query in the body of the document. The query should be formatted as allintext: followed by the words in your search query.
If your search query includes the allintext: query term, Google will only check the body text of documents for the words in your search query, ignoring links in those documents, document titles and document URLs."
"The intitle: query term restricts search results to documents that contain a particular word in the document title. The search query should be formatted as intitle:WORD with no space between the intitle: query term and the following word."
"The allintitle: query term restricts search results to documents that contain all of the query words in the document title. To use the allintitle: query term, include "allintitle:" at the start of your search query.
Note: Putting allintitle: at the beginning of a search query is equivalent to putting intitle: in front of each word in the search query."
"The inurl: query term restricts search results to documents that contain a particular word in the document URL. The search query should be formatted as inurl:WORD with no space between the inurl: query term and the following word"
The allinurl: query term restricts search results to documents that contain all of the query words in the document URL. To use the allinurl: query term, include allinurl: at the start of your search query.
as_* terms do not work for Google Newsallinlinks:related:Tip. If you want to build a near real-time feed for a specific topic, use when='1h'. If Google captured fewer than 100 articles over the past hour, you should be able to retrieve all of them.
Check the Useful Links section if you want to dig into how Google Search works.
Especially, Special Query Terms section of Google XML reference.
Plus, I will provide some more examples under the Full-Text Search Examples section
All 4 functions return the dictionary that has 2 sub-objects:
feed - contains the information on the feed metadataentries - contains the parsed articlesBoth are inherited from the Feedparser. The only change is that each dictionary under entries also contains sub_articles which are the similar articles found in the description. Usually, it is non-empty for top_news() and topic_headlines() feeds.
Tip To check what is the found feed's name just check the title under the feed dictionary
Every function has scrapingbee parameter. It accepts your ScrapingBee API key that will be used to get the response from Google's servers.
You can take a look at what exactly is happening in the source code: check for __scaping_bee_request() function under GoogleNews class
Pay attention to the concurrency of each plan at ScrapingBee
How to use example:
gn = GoogleNews()
# it's a fake API key, do not try to use it
gn.top_news(scraping_bee = 'I5SYNPRFZI41WHVQWWUT0GNXFMO104343E7CXFIISR01E2V8ETSMXMJFK1XNKM7FDEEPUPRM0FYAHFF5')
So, if you have your own HTTP/HTTPS proxy(s) that you want to use to make requests to Google, that's how you do it:
gn = GoogleNews()
gn.top_news(proxies = {'https':'34.91.135.38:80'})
boeing and do not mention airbusfrom pygooglenews import GoogleNews
gn = GoogleNews()
s = gn.search('boeing -airbus')
print(s['feed'].title)
# "boeing -airbus" - Google News
boeing in titlefrom pygooglenews import GoogleNews
gn = GoogleNews()
s = gn.search('intitle:boeing')
print(s['feed'].title)
# "intitle:boeing" - Google News
boeing in title and got published over the past hourfrom pygooglenews import GoogleNews
gn = GoogleNews()
s = gn.search('intitle:boeing', when = '1h')
print(s['feed'].title)
# "intitle:boeing when:1h" - Google News
boeing or airbusfrom pygooglenews import GoogleNews
gn = GoogleNews()
s = gn.search('boeing OR airbus', when = '1h')
print(s['feed'].title)
# "boeing AND airbus when:1h" - Google News
Stack Overflow thread from which it all began
Google XML reference for the search query
Google News Search parameters (The Missing Manual)
My name is Artem. I ❤️ working with news data. I am a co-founder of NewsCatcherAPI - Ultra-fast API to find news articles by any topic, country, language, website, or keyword
If you are interested in hiring me, please, contact me by email - bugara.artem@gmail.com or artem@newscatcherapi.com
Follow me on 🖋 Twitter - I write about data engineering, python, entrepreneurship, and memes.
Want to read about how it all was done? Subscribe to CODARIUM
thx to Kizy
v0.1.1 -- fixed language-country issues
FAQs
If Google News had a Python library
We found that pygooglenews demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers 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
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.