biomunky/newsapi

An API for interacting with the News API

The News API Rust Library

• The News API Rust Library
  • Breaking changes**
  • Summary
  • Notes
  • Examples
  • License
  • Disclaimer

The News API allows you to get breaking news headlines, and search for articles from over 30,000 news sources and blogs.

Breaking changes**

• Version 0.5.x renames the Client struct to NewsAPIClient. See examples for demonstrated usage.

• Version 0.4.x introduces async fetch. While synchronous functionality is retained, the relevant functions have been renamed. Please check examples for further details. The core change is send has been replaced with send_async and send_sync for the asynchronous and synchronous variants respectively.

Summary

All you need is an API key to

• Search live top headlines or search all articles
• New articles available with 15 minute delay
• And Search articles up to a month old
• Get short article snippet or descriptions

The following limits apply

• 1,000 requests per day
• No extra requests available
• No uptime SLA
• Basic support
• NewsAPI.org attribution required

See here for pricing

Notes

There are three endpoints

1. Top Headlines
2. Everything
3. Sources

Top Headlines and Everything endpoints are wrapped by an Article struct and Sources by a Source struct. Both currently provide limited functionality.

Examples

As described in The Cargo Book the project has some simple examples in examples/. These can be run via cargo after you've exported your NEWSAPI_KEY

export NEWSAPI_KEY=5h79off128957edb3179y5da1nb36y9e

To list all examples:

cargo run --example

to run a specific example

cargo run --example get_sources_async

License

Licensed under MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Disclaimer

We have no affiliation with the News API team.