Skip to main content

Google News search for Python

Project description

GoogleNews

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

Install

pip install GoogleNews

or

pip install --upgrade GoogleNews

Usage

  • Initializing
from GoogleNews import GoogleNews
googlenews = GoogleNews()
  • Check version
print(googlenews.getVersion())
  • Enable to throw exception
googlenews.enableException(True)
  • Optional choose language
googlenews = GoogleNews(lang='en')

or

googlenews = GoogleNews(lang='en', region='US')
  • 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')

or

googlenews.set_lang('en')
googlenews.set_period('7d')
googlenews.set_time_range('02/01/2020','02/28/2020')
googlenews.set_encode('utf-8')
  • news.google.com search sample
googlenews.get_news('APPLE')
  • **news.google.com get news by topics
# Sports
googlenews.set_topic('CAAqKggKIiRDQkFTRlFvSUwyMHZNRFp1ZEdvU0JYQjBMVUpTR2dKQ1VpZ0FQAQ')
googlenews.get_news()
  • **news.google.com get news by topic and sections
# Sports
googlenews.set_topic('CAAqKggKIiRDQkFTRlFvSUwyMHZNRFp1ZEdvU0JYQjBMVUpTR2dKQ1VpZ0FQAQ')
# Football Soccer
googlenews.set_section('CAQiS0NCQVNNZ29JTDIwdk1EWnVkR29TQlhCMExVSlNHZ0pDVWlJT0NBUWFDZ29JTDIwdk1ESjJlRFFxQ3dvSkVnZEdkWFJsWW05c0tBQSouCAAqKggKIiRDQkFTRlFvSUwyMHZNRFp1ZEdvU0JYQjBMVUpTR2dKQ1VpZ0FQAVAB')

googlenews.get_news()
  • google.com section news search sample (Not working anymore)
googlenews.search('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:

googlenews.get_page(2)
  • 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) (Note: this function is not available for googlenews.search())
googlenews.total_count()
  • Get results will return the list, [{'title': '...', 'media': '...', 'date': '...', 'datetime': '...', 'desc': '...', 'link': '...', 'img': '...'}]
googlenews.results()

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
googlenews.get_texts()
  • Get links returns the list of news links
googlenews.get_links()
  • Clear result list before doing another search with the same object
googlenews.clear()

Issue

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.

Source Distribution

googlenews-1.6.16.tar.gz (8.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

googlenews-1.6.16-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file googlenews-1.6.16.tar.gz.

File metadata

  • Download URL: googlenews-1.6.16.tar.gz
  • Upload date:
  • Size: 8.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for googlenews-1.6.16.tar.gz
Algorithm Hash digest
SHA256 4d5efc829e3c94099038c93da20f352d3fd6bafce1997bd6f340e7f04220b637
MD5 2cee2f711cc5ee51b0b50421443e0626
BLAKE2b-256 5bdc1aa39ffb8ef73c41733c4324c15026435ffbd56e1fde8dbcbb502483d3a2

See more details on using hashes here.

File details

Details for the file googlenews-1.6.16-py3-none-any.whl.

File metadata

  • Download URL: googlenews-1.6.16-py3-none-any.whl
  • Upload date:
  • Size: 8.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for googlenews-1.6.16-py3-none-any.whl
Algorithm Hash digest
SHA256 415344868c6ac912c065ff9a215840e454cb94ae8427521b9a43b04fce74c32f
MD5 649dba61bcdae811be91085dbb919f11
BLAKE2b-256 be443745228f6960c192e4afa2d9478e1dc9c93ada594399d9d366f4b7927d03

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page