Giter Site home page Giter Site logo

khoaakt / google-news-rss Goto Github PK

View Code? Open in Web Editor NEW

This project forked from brh55/google-news-rss

0.0 1.0 0.0 76 KB

🗞 A node module (with browser support) that searches Google News RSS Feed and returns a usable JSON response

License: MIT License

JavaScript 100.00%

google-news-rss's Introduction

google-news-rss Travis branch Coveralls branch npm badge

🗞 A node module (with browser support) that searches Google News RSS Feed and returns a usable JSON response

This is an unofficial, super easy to use node module / API client that allows a user to fetch a Google News RSS feed based on search terms and returns an easy to use JSON response. google-news-rss also supports in-browser requests.

RSS Example

Coverts ⬇️

{
   title: "Are there really antioxidants in that juice? How to protect against food fraud.",
   description: "Regrettably, they are examples of food fraud that are perpetrated on unsuspecting Americans. The global food industry loses $10 billion to $15 billion per year through food substitutions, dilutions and fake labels, according to the Grocery ...",
   pubDate: "Wed, 08 Jun 2017 07:01:30 GMT",
   thumbnailUrl: "//t1.gstatic.com/images?q=tbn:ANd9GcS7OWziKD2Lc3zReERlqVcffAcgIuzzq723AR4zF807dKuqhzMY6EUEpQyzwGzHXpE05gGtFHNC",
   publisher: "Washington Post",
   link: "http://news.google.com/news/url?sa=t&fd=R&ct2=us&usg=AFQjCNEeo82SxlrQZP5SzjugGtJHFt36_g&clid=c3a7d30bb8a4878e06b80cf16b898331&ei=rCJqWYjEINKMzgKc_YDgCQ&url=https://www.washingtonpost.com/lifestyle/wellness/are-there-really-antioxidants-in-that-juice-how-to-protect-against-food-fraud/2017/06/07/fec98462-4554-11e7-bcde-624ad94170ab_story.html"
}

Install

$ npm install --save google-news-rss

Usage

const GoogleNewsRss = require('google-news-rss');

const googleNews = new GoogleNewsRss();

googleNews
   .search('unicorns')
   .then(resp => console.log(resp));

//
// [
//   {
//      title: 'Why don\'t unicorns exist? You asked Google – here\'s the answer ...',
//      link: 'http://news.google.com/news/url?sa=t&fd=R&ct2=us&usg=AFQjCNGNR4Qg8LGbjszT1yt2s2lMXvvufQ&clid=c3a7d30bb8a4878e06b80cf16b898331&cid=52779522121279&ei=VQU7WYjiFoLEhQHIs4HQCQ&url=https://www.theguardian.com/commentisfree/2017/jun/07/why-dont-unicorns-exist-google',
//      pubDate: 'Wed, 07 Jun 2017 07:01:30 GMT',
//      description: 'Imagine for a second that you’re God. You’ve created the universe in six days (seven under EU working time directives). You’ve created millions of creatures of unimaginable grace, oddness and beauty',
//      publisher: 'The Guardian',
//      imgSrc: '//t2.gstatic.com/images?q=tbn:ANd9GcRa2NGl3_alXByd3kpnDDImMJFGeskk4Mf_AWZc-ohe_O8iEtmBs7hMxieldT_--jQWuDr4gQc'
//    }
//  ... 9 more articles
// ]

API

GoogleNewsRss()

Type: class
Usage: new GoogleNewsRss()

Instance Methods

.search(terms[, num, language, extraParams])

Returns: Promise that resolves n formatted articles

terms

Type: string

Search terms to search for within Google news. IE: ethereum,btc

num

Type: int
Default: 10

Number of results to be returned [1...30].

language

Type: string
Default: en

Language of the results within Google News. IE: pt-BR

Returns: Promise that resolves 10 formatted articles

extraParams

Type: object

Any additional query params that are appended to RSS url to refine the results. Please note, there aren't any officially documented parameters so your mileage may vary. Feel free to experiment with some of the params listed on this blog post provided by i-tweak.

Article Properties

Properties Description Example
title Title of the article Why don't unicorns exist? You asked Google – here's the answer ... - The Guardian
link Google news link to article Article Link
pubDate Published date Wed, 07 Jun 2017 07:01:30 GMT
description Short description of article Why don't unicorns exist? You asked Google - here's the answer ...
thumbnailUrl Thumbnail Url. Omitted when not available. //t2.gstatic.com/images?q=tbn:ANd9GcRa2NGl3_alXByd3kpnDDImMJFGeskk4Mf_AWZc-ohe_O8iEtmBs7hMxieldT_--jQWuDr4gQc
publisher Publisher of article The Guardian

License

MIT © Brandon Him

google-news-rss's People

Contributors

adalbueno avatar brh55 avatar khoaakt avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.