Skip to main content

A command line program in Python.

Project description

PyPI version

A command line application for displaying news headlines, written in Python.

Getting Started



Newsapi-cli is on PyPI so it can be installed with pip.

$ pip install newsapi-cli

To upgrade use the -U flag.

$ pip install -U newsapi-cli

Alternatively get the source and install locally.

$ pip install -e ./newsapi-cli/

Adding your API key

To begin you will need to add your API key. If you do not have an API key you can get one free from News API.

$ news api YOUR00API00KEY00GOES00HERE

Using newsapi-cli

  news sources
  news <source>
  news search <keyword>
  news -h | --help
  news --version

Display a list of all news sources

$ news sources

Get headlines from a specific source

$ news <source>

Get headlines related to a keyword

$ news search <keyword>


Get news headlines from the bbc-news source.

$ news bbc-news

Get top news headlines for Great Britain.

$ news gb

Get top business news headlines for Great Britain.

$ news gb/business

Get top headlines about apple.

$ news search apple

Built With


This project is licensed under the MIT License

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 newsapi-cli, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size newsapi_cli-1.2.1-py2.py3-none-any.whl (8.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size newsapi-cli-1.2.1.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page