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.

Source Distribution

newsapi-cli-1.2.1.tar.gz (4.8 kB view hashes)

Uploaded Source

Built Distribution

newsapi_cli-1.2.1-py2.py3-none-any.whl (8.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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