node package manager
We need your input. Help make JavaScript better: Take the 2017 JavaScript Ecosystem survey »



Track the completion of sports games from a URL.

NPM Build Status Greenkeeper badge


const Scores = require('scores');
new Scores({
  url: '',
  interval: '5m', // or a number of ms 
  timezone: 'America/New_York',
  dailyCutoff: 180, // in minutes, 
  completed: { seriesCompleted: true }, // passed to _.filter to decide if an event is completed 
  parse: {
    // Is used to try and guess the ending time of the event 
    // In this case we are checking for college basketball where 
    // there are two 20 minute halves. Eg NBA would be '12m' and 4 
    finalPeriod: 2,
    periodLength: '20m' // or a number of ms 
// Will be fired on the completion of each game 
.on('event', (game) => console.log(game))
// Start the watcher 

How does it work?

It intermittently parses the DOM of the URL to see if any games have been completed. There is also logic for what to do in situations where there are no games that day or none of the games have started, or all the games have finished.


new Scores(options)

  • options.interval (Integer, default: 15) Interval in minutes for how often to request the url
  • options.timezone (String, default: 'America/New_York') A moment-timezone string for which timezone you want to base dates off
  • options.dailyCutoff (Integer, default: 180) The amount of minutes after midnight that the date should switch. This allows you to keep checking for the games that might go past midnight.
  • options.url (String) The url to request. {date} will be replaced with today's date as YYYYMMDD
  • options.logger A bucker compatible instance which will log interesting things
  • options.parse (Object) Options that will be passed directly to the parse method


  • start() Start the interval to watch for new games
  • stop() Stop watching


  • scores.on('event', event => { ... })
  • scores.on('error', err => { ... })

MIT License