bioRxiv API Summary

Reports Page

A set of reports is available here.

Content detail

The format of the endpoint is https://api.biorxiv.org/detail/[interval]/[cursor]/[format] or https://api.biorxiv.org/detail/[DOI]/na/[format]

where 'interval' can be 1) two YYYY-MM-DD dates separted by '/' and 'cursor' is the start point which defaults to 0 if not supplied, or 2) a numeric value for the N most recent posts, or 3) a numeric with the letter 'd' for the most recent N days of posts.

Where metadata for multiple papers is returned, results are paginated with 100 papers served in a call. The 'cursor' value can be used to iterate through the result.

For instance, https://api.biorxiv.org/detail/2018-08-21/2018-08-28/45 will output 100 results (if that many remain) within the date range of 2018-08-21 to 2018-08-28 beginning from result 45.

https://api.biorxiv.org/detail/[DOI]/na/[format] returns detail for a single manuscript. For instance, https://api.biorxiv.org/detail/10.1101/339747 will output metadata for the paper with DOI 10.1101/339747.

The 'messages' array in the output provides information about what is being displayed, including cursor value, count of all items and count of new papers for the requested interval.

Available formats are JSON (json) and XML (OAI-PMH XML).

The following metadata elements are returned:

Published article detail

The format of the endpoint is https://api.biorxiv.org/pub/[interval]/[cursor][format]

where 'interval' can be 1) two YYYY-MM-DD dates separted by '/' and 'cursor' is the start point which defaults to 0 if not supplied, or 2) a numeric value for the N most recent published articles, or 3) a numeric with the letter 'd' for the most recent N days of articles.

Results are paginated with 100 articles served in a call. The 'cursor' value can be used to iterate through the result.

For instance, https://api.biorxiv.org/pub/2017-08-21/2017-08-28/30 will output 100 articles (if that many remain) within the date range of 2018-08-21 to 2018-08-28 beginning from article 30.

The 'messages' array in the output provides information about what is being displayed, including cursor value and count of items for the requested interval.

The default output format is JSON and CSV download is also available, eg https://api.biorxiv.org/pub/2017-08-21/2017-08-28/30/csv.

The following metadata elements are returned:

Publisher article detail

This endpoint returns information about bioRxiv papers that have been published by a specific publisher. The format of the endpoint is https://api.biorxiv.org/publisher/[publisher prefix]/[interval]/[cursor]

The publisher parameter is the publisher prefix, which is a string of the publisher prefix, eg '10.15252' (prior to any slash).

'interval' can be 1) two YYYY-MM-DD dates separted by '/' and 'cursor' is the start point which defaults to 0 if not supplied, or 2) a numeric value for the N most recent published articles, or 3) a numeric with the letter 'd' for the most recent N days of articles.

Results are paginated with 100 articles served in a call. The 'cursor' value can be used to iterate through the result.

For instance, https://api.biorxiv.org/publisher/10.15252/2018-01-01/2019-01-01/0 will output 100 articles (if that many remain) within the date range of 2018-08-21 to 2018-08-28 beginning from article 1 for biorxiv papers published with any DOI that begins with the publisher prefix '10.15252'.

The 'messages' array in the output provides information about what is being displayed, including cursor value and count of items for the requested interval.

The following metadata elements are returned:

Content Summary Statistics

The format of the endpoint is https://api.biorxiv.org/sum/[interval]/[format]

where 'interval' can equal 'm' (monthly) or 'y' (yearly).

For instance, https://api.biorxiv.org/sum/m will output monthly new and revised paper interval and cumulative counts.

The default format is JSON. A value of 'csv' will force the output to download as a CSV file, eg https://api.biorxiv.org/sum/m/csv

The following metadata elements are returned:

Usage Summary Statistics

The format of the endpoint is https://api.biorxiv.org/usage/[interval]/[format]

where 'interval' can equal 'm' (monthly) or 'y' (yearly).

For instance, https://api.biorxiv.org/usage/m will output monthly usage counts for abstract views, full text views and PDF downloads.

The default format is JSON. A value of 'csv' will force the output to download as a CSV file, eg https://api.biorxiv.org/usage/m/csv

The following metadata elements are returned: