newsapi

README

NEWSAPI

This library makes it about as painless as possible to retrieve articles from a variety of news sources, using newsapi. Quick, dirty golang bindings. Either set the NEWSAPI environment variable when integrating this library in your code, or set newsapi.token

Examples

Search: NEWSAPI=sometoken newsapi.Search("A search term")

Search for a specific date: NEWSAPI=sometoken newsapi.SearchForDate("A search term", "2020-01-01")

For complete examples, see the unit tests.

Documentation

Index

• type Article
  • func Search(terms string) ([]Article, error)
  • func SearchForDate(terms string, date time.Time) ([]Article, error)
  • func SearchForDateAndDomain(terms string, date time.Time, domain string) ([]Article, error)
  • func SearchForDomain(terms string, domain string) ([]Article, error)

Types

type Article

type Article struct {
	Author      string
	Title       string
	Description string
	URL         string
	PublishedAt time.Time `json:publishedAt`
	Content     string
	UrlToImage  string `json:urlToImage`
}

func Search

func Search(terms string) ([]Article, error)

Search news terms

func SearchForDate

func SearchForDate(terms string, date time.Time) ([]Article, error)

Search news terms on the specific date

func SearchForDateAndDomain

func SearchForDateAndDomain(terms string, date time.Time, domain string) ([]Article, error)

Search news terms on a specific date and domain

func SearchForDomain

func SearchForDomain(terms string, domain string) ([]Article, error)

Search news terms on a specific domain