getpapers

getpapers

Get fulltexts or fulltext URLs of papers matching a search query using any of the following APIs:

• EuropePMC
• IEEE
• ArXiv

getpapers can fetch article metadata, fulltexts (PDF or XML), and supplementary materials. It's designed for use in content mining, but you may find it useful for quickly acquiring large numbers of papers for reading, or for bibliometrics.

Installation

$ npm install --global getpapers

Usage

Use getpapers --help to see the command-line help:

Usage: getpapers [options]

Options:

  -h, --help              output usage information
  -V, --version           output the version number
  -q, --query <query>     Search query (required)
  -o, --outdir <path>     Output directory (required - will be created if not found)
  --api <name>            API to search [arxiv, eupmc, ieee] (default: eupmc)
  -x, --xml               Download fulltext XMLs if available
  -p, --pdf               Download fulltext PDFs if available
  -s, --supp              Download supplementary files if available
  -l, --loglevel <level>  amount of information to log (silent, verbose, info*, data, warn, error, or debug)
  -a, --all               search all papers, not just open access

By default, getpapers uses the EuropePMC API.

Screenshot

Query formats

Each API has its own query format. Usage guides are provided on our wiki:

• EuropePMC query format
• IEEE query format
• ArXiv query format

License

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