ContentMine / node-journalTOCs

Node.js client for the JournalTOCs API

node-journalTOCs

JournalTOCs API client

JournalTOCs is a wonderful service that provides tables of contents for the latest issue of almost every academic journal.

node-journalTOCs is a very simple Node.js client for the JournalTOCs API that exposes methods for searching journals by keyword or ISSN and retrieving articles by journal ISSN.

Installation

$ npm install --save journaltocs

Documentation

The (Journals) API is supported. The other APIs are not supported (if you particularly want them, please open an issue requesting them).

Examples

// load the module
var JournalTOCs = require('journaltocs');
var email = "[e-mail]"
var jt = new JournalTOCs(email);


// find journals matching a query
var query = jt.findJournals('bioinformatics');
var bioinf_journals;

query.on('result', function(result) {
  // result is an array of objects, one per journal
  console.log(result);
  bioinf_journals = result;

  // get ISSN of the first match
  var issn = bioinf_journals[0]['prism:issn'];
});


// get details of the journal
query2 = jt.journalDetails('1460-2059');

query2.on('result', function(result) {
  // result is an object with details of the journal
  console.log(result.title); // Bioinformatics
});

// get latest articles from the journal
query3 = jt.journalArticles('1460-2059');

query3.on('result', function(result) {
  // result is an array of objects, one per article
  console.log(result[0]);
});

Contributing

This is intended to be a lightweight client, so new features should be discussed first on the issue tracker. However, bug reports are welcome.

License

Copyright (c) 2014 Shuttleworth Foundation Licensed under the MIT license.