Skip to main content

Google News search for Python

Project description


Build Status Coverage Status PyPI PyPI - Downloads PyPI - Python Version PyPI - Wheel GitHub contributors GitHub issues GitHub Action GitHub


pip install GoogleNews


pip install --upgrade GoogleNews


  • Initializing
from GoogleNews import GoogleNews
googlenews = GoogleNews()
  • Optional choose language
googlenews = GoogleNews(lang='en')
  • Optional choose period (period and custom day range should not set together)
googlenews = GoogleNews(period='7d')
  • Optional choose custom day range (mm/dd/yyyy)
googlenews = GoogleNews(start='02/01/2020',end='02/28/2020')
  • Optional set encode
googlenews = GoogleNews(encode='utf-8')


  • search sample
  • section news search sample'APPLE')

Default return first page result, you don't need to get first page again, otherwise you might get duplicate result. To get other page of search results:

  • If you only want to get specific page
result = googlenews.page_at(2)
  • If you want to get the total result number of the search(this is approximate number, not exact number, it is the number showing on the google search page)
  • Get results will return the list, [{'title': '...', 'media': '...', 'date': '...', 'datetime': '...', 'desc': '...', 'link': '...', 'img': '...'}]

if googlenews.results(sort=True) the tool will try to order the results in cronologically reversed order

  • Get texts will return the list of news titles
  • Get links returns the list of news links
  • Clear result list before doing another search with the same object


Image is not working in the latest version, it can only return default google loading gif

The date range is not always working as Google may return the result with random order or out of date range.

Google may recognize the program as automated robots and block the IP, using cloud server and fetching data with high frequency will get higher chance to be blocked.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for GoogleNews, version 1.5.7
Filename, size File type Python version Upload date Hashes
Filename, size GoogleNews-1.5.7-py3-none-any.whl (7.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size GoogleNews-1.5.7.tar.gz (6.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page