BioMed Central API

The BioMed Central public API is a RESTful API for retrieving BMC specific content. The API is used via the HTTP protocol through GET requests. Resources are represented in JSON format.

The starting point is a single bookmark URL known as root (/webapi) followed by version . The root contains URIs for the available resources and for the operations which may be performed upon them (e.g. latest articles, editor's picks etc.).

BioMed Central currently provides following content API:

  • Latest Articles: To retrieve latest articles published by BioMed Central.
  • Editors picks: To retrieve highlight articles chosen by the editors.
  • Search: To search on BioMed Central bibliographic database.
  • Transport Protocol

    The BioMed Central public API is based on the Hypertext Transfer protocol, version 1.1 (RFC 2616). Client authentication is handled using HTTP Basic Authentication (RFC 2617).

    Endpoint

    All BioMed Central APIs are hosted on www.biomedcentral.com. The root URI for API resources is /webapi/1.0 with an exception to the search API.

    Success and failure

    Requests that result in a successful operation will return an HTTP status code such as 200 OK, and a success message with an application/JSON response. Requests that result in a failed operation will return an HTTP status code such as 400 Bad Request, and an error message with an application/JSON response.

    BioMed Central Public API

    Latest Articles

    This API provides latest articles in journals published by BioMed Central. The resource latest_articles.json is available under /webapi/1.0. The number of latest articles returned is controlled by the editors of the journal.

    URI: /webapi/1.0/latest_articles.json
    Parameters: none
    Valid endpoint: http://www.biomedcentral.com/webapi/1.0/latest_articles.json
    Result: Useful bibliographic information of latest articles.

    Sample result

    {"articles":[
        {"citation":"<i>Critical Care</i> 2012, <b>16</b>:410",
        "is_subscription":"false",
        "is_open_access":"false",
        "is_highly_accessed":"false",
        "image_credit":"",
        "article_type":"Letter",
        "article_url":"/content/16/1/410",
        "authors":"\r\n<span class="author-names">Liu ZJ, Liu JL and Qu HP</span>\r\n",
        "title":"<p>Inflammasome and caspase-1 inhibition<sub>L </sub>may influence cytokine
    responses of lipopolysaccharide-stimulated peripheral blood mononuclear cells</p>", "blurbText":"", "rss_url":"/rss", "thumbnailUrl":"/content/figures/cc11156-toc.gif", "publication_date":"8 February 2012", "article_host":"ccforum.com", "is_free":true}]}

    Editors Picks

    Editor's picks are the highlight articles on a journal that have been selected by editors to highlight interesting research on their journals. The resource /editors_picks.json is used to retrieve these articles. The number of articles returned is controlled by the editors.

    URI: /webapi/1.0/editors_picks.json
    Parameters: none
    Valid endpoint: http://www.biomedcentral.com/webapi/1.0/editors_picks.json
    Result: Useful bibliographic information of editor's picks articles.

    Sample result

    {"articles":[
        {"citation":"<i>Diabetology & Metabolic Syndrome</i> 2012 <b>4</b>:5",
        "long_title":"Muscle protein metabolism in neonatal alloxan-administered rats: effects
    of continuous and intermittent swimming training.", "issue":"1", "image_credit":"Flickr by jepoirrier", "journal_name":"Diabetology & Metabolic Syndrome", "editors_summary":"In response to glucose overload, rats that had received swimming training
    were better able to generate an insulin secretory response. Additionally, rats that received
    continuous training also had an improved glucose tolerance.", "article_url":"/content/4/1/5", "short_title":"The effect of training on diabetic model rats", "interest_level":4", "first_page":"5", "image_url":"/content/figures/1758-5996-4-5-toc.gif", "volume":"4", "publication_year":"2012", "publication_date":"6 February 2012", "article_host":"www.dmsjournal.com", "doi":""}]}

    Search

    Search is now available in JSON formatted results. All searches on BioMed Central platform can now be obtained in JSON format by adding format=json parameter to the query string. any search that can be run on journal sites can be used to return JSON responses. It also supports pagination.

    URI: /search/results

    Parameters:
    terms=<search terms>
    itemsPerPage=<number>
    page=<number>
    format=json

    Endpoint: http://www.biomedcentral.com/search/results?terms=abnormal&format=json
    Result: Bibliographic information of articles.

    Sample response

    {"entries":[
        {"arxId":"cc11156",
        "blurbTitle":"",
        "blurbText":"",
        "imageUrl":"/content/figures/cc11156-toc.gif",
        "articleUrl":"/content/16/1/410",
        "articleFullUrl":"http://ccforum.com/content/16/1/410",
        "type":"letter",
        "doi":"",
        "isOpenAccess":"false",
        "isFree":"true",
        "isHighlyAccessed":"false",
        "bibliograhyTitle":"<p>Inflammasome and caspase-1 inhibition caused by Bcl-2 and Bcl-X
    <sub>L</sub>may influence cytokine responses of lipopolysaccharide-stimulated peripheral blood
    mononuclear cells from septic patients</p>", "authorNames":"\n<span class="author-names">Liu ZJ, Liu JL and Qu HP</span>\n", "longCitation":"<em>Critical Care</em> 2012, <strong>16</strong>:410 (8 February 2012)", "status":"LIVE", "abstractPath":"http://ccforum.com/content/16/1/410/abstract"}] }

Submit a manuscript Sign up for article alerts