anchor.diff:      "version": "cristhian"
   }
   
  +
   --
  -item
  +add an item
  +<a id="post_item"></a>
  +Add an item to the ImpactStory system using the given namespace and id.  
  +Returns `201` even if the item is already in the database, because this call also registers the item as sponsored under the supplied API Key (see top of this page for more information).
  +
  +After POSTing an item, the item data can be obtained through [GET /item](#get_item) calls.
  +--
  +Add an item to the ImpactStory system using the given namespace and id.  There is no data payload to the POST.
  +
  +This example uses a PubMed ID.  See the [GET /item](#get_item) section for more examples of valid namespaces and ids.
  +POST /v1/item/pmid/20807452?key=YOURKEY
  +< 201
  +"ok"
  +
  +
  +
  +
  +--
  +get item data
  +<a id="get_item"></a>
   The following is a section of resources related to research items
  +
  +- Returns `200` if the item metrics are available.
  +- Returns `210` if the item is currently being updated.  Updating an item usually takes less than ten seconds, but can take longer depending on ImpactServer 
  +server load or lag/errors from our metrics providers.  The API caller can poll slowly until a `200` is received.
  +- Returns `404` if item has not yet been added to ImpactStory.  In that case, a [POST /item](#post_item) call must be made before a GET call will be successful.
   --
  -Add a research item to the ImpactStory database.  Required to initiate collection of metrics.
  -POST /v1/item/pmid/22075173?key=YOURKEY
  -> Content-Type: application/json
  -{ "namespace":"doi", "id": "10.1371/journal.pcbi.1000355" }
  -< 201
  -< Content-Type: application/json
  -{ "status": "created", "url": "/shopping-cart/2" }
  -
  -Get metrics and biblio information on the item
  -GET /v1/item/pmid/22075173?key=YOURKEY
  -> Content-Type: application/json
  -{ "namespace":"doi", "id": "10.1371/journal.pcbi.1000355" }
  +**Articles with PubMed IDs** Get metrics and biblio information on the item
  +will return a `210` while still updating, then a `200`
  +GET /v1/item/pmid/20807452?key=YOURKEY
   < 200
   < Content-Type: application/json
   {
  -    "_id": "",
  -    "_rev": "",
  -    "aliases": {},
  -    "biblio":{},
  -    "metrics": {},
  -    "type": "item"
  -}
  -
  -Get metrics and biblio information on the item
  -GET /v1/item/doi/10.1186/1756-0500-4-487?key=YOURKEY
  -> Content-Type: application/json
  -{ "namespace":"doi", "id": "10.1371/journal.pcbi.1000355" }
  -< 200
  -< Content-Type: application/json
  -{
  -    "_id": "",
  -    "_rev": "",
  -    "aliases": {},
  -    "biblio":{},
  -    "metrics": {},
  -    "type": "item"
  -}
  -
  -Get metrics and biblio information on the item
  -GET /v1/item/github/egonw,cdk
  -> Content-Type: application/json
  -{ "namespace":"doi", "id": "10.1371/journal.pcbi.1000355" }
  -< 200
  -< Content-Type: application/json
  -{
  -    "_id": "",
  -    "_rev": "",
  -    "aliases": {},
  -    "biblio":{},
  -    "metrics": {},
  -    "type": "item"
  -}
  -
  -Get metrics and biblio information on the item
  -GET /v1/item/url/http://www.slideshare.net/cavlec/who-owns-our-work
  -> Content-Type: application/json
  -{ "namespace":"doi", "id": "10.1371/journal.pcbi.1000355" }
  -< 200
  -< Content-Type: application/json
  -{
  -    "_id": "",
  -    "_rev": "",
  -    "aliases": {},
  -    "biblio":{},
  -    "metrics": {},
  -    "type": "item"
  -}
  -
  -
  -Get metrics and biblio information on the item
  -GET /v1/item/pmid/22075173?key=EXAMPLE
  -< 200
  -< Content-Type: application/json
  -{
  -    "_id": "b229e24abec811e1887612313d1a5e63",
  -    "_rev": "48-9db4640518e4a03df634d25cb3692f85",
  +    "_id": "c5vh88e15ad42z9dmo1h08wi",
  +    "_rev": "8-6a7ece51607be9657d25cb979574e4db",
       "aliases": {
  -        "created": "2012-06-25T13:21:38.965215",
  +        "biblio": [
  +            {
  +                "authors": "Nyman, Vikberg, Smith, Boev\u00e9",
  +                "journal": "BMC Evolutionary Biology",
  +                "repository": "Springer (Biomed Central Ltd.)",
  +                "title": "How common is ecological speciation in plant-feeding insects? A 'Higher' Nematinae perspective",
  +                "year": 2010
  +            }
  +        ],
           "doi": [
  -            "10.1371/journal.pcbi.1000355"
  -        ],
  -        "last_modified": "2012-06-25T13:21:40.293053",
  -        "title": [
  -            "An Analytically Solvable Model for Rapid Evolution of Modular Structure"
  +            "10.1186/1471-2148-10-266"
  +        ],
  +        "pmid": [
  +            "20807452"
           ],
           "url": [
  -            "http://www.ncbi.nlm.nih.gov/pubmed/19360090",
  -            "http://dx.plos.org/10.1371/journal.pcbi.1000355"
  +            "http://www.biomedcentral.com/1471-2148/10/266"
           ]
       },
       "biblio": {
  -        "authors": "Kashtan, Mayo, Kalisky, Alon",
  +        "authors": "Nyman, Vikberg, Smith, Boev\u00e9",
           "genre": "article",
  -        "h1": "An Analytically Solvable Model for Rapid Evolution of Modular Structure",
  -        "journal": "PLoS Comput Biol",
  -        "title": "An Analytically Solvable Model for Rapid Evolution of Modular Structure",
  -        "year": 2009
  -    },
  -    "created": "2012-06-25T13:21:38.965201",
  +        "journal": "BMC Evolutionary Biology",
  +        "repository": "Springer (Biomed Central Ltd.)",
  +        "title": "How common is ecological speciation in plant-feeding insects? A 'Higher' Nematinae perspective",
  +        "year": 2010
  +    },
  +    "created": "2012-11-23T22:00:37.209395",
       "currently_updating": false,
  -    "last_modified": "2012-08-04T07:46:46.449842",
  +    "last_modified": "2012-11-23T22:00:44.087665",
       "metrics": {
           "citeulike:bookmarks": {
  -            "provenance_url": "http://www.citeulike.org/doi/10.1371/journal.pcbi.1000355",
  +            "provenance_url": "http://www.citeulike.org/doi/10.1186/1471-2148-10-266",
               "static_meta": {
                   "description": "Number of users who have bookmarked this item.",
                   "display_name": "bookmarks",
  
positive.code: HOST: http://api.impactstory.org/
  
  --- ImpactStory v1 api ---
  ---
  Welcome to the our version 1 API documentation. All comments can be written in (support [Markdown](http://daringfireball.net/projects/markdown/syntax) syntax)
  
  We only guarantee updated metrics for items with an ImpactStory-supplied api key. 
  To request an ImpactStory-supplied api key, send an email to team@impactstory.org
  
  The examples below are for getting metrics for a [BMC Research Notes paper](http://www.biomedcentral.com/1756-0500/4/487) using its [PubMed ID 22075173](http://www.ncbi.nlm.nih.gov/pubmed/22075173). 
  Alternatively, it could be queried by its DOI (10.1186/1756-0500-4-487) by replacing the namespace and identifier in the examples below.  For example, /v1/item/pmid/22075173?key=YOURKEY returns the same values as /v1/item/doi/10.1186/1756-0500-4-487?key=YOURKEY
  
  ---
  
  --
  about
  --
  GET /v1?key=YOURKEY
  < 200
  < Content-Type: application/json
  
negative.code:             },
              "values": {
                  "WoS": {
                      "CI95_lower": 81,
                      "CI95_upper": 96,
                      "estimate_lower": 88,
                      "estimate_upper": 93
                  },
                  "raw": 1
              }
          },
          "mendeley:readers": {
              "provenance_url": "http://api.mendeley.com/research/common-ecological-speciation-plant-feeding-insects-higher-nematinae-perspective/",
              "static_meta": {
                  "description": "The number of readers who have added the article to their libraries",
                  "display_name": "readers",
  