anchor.diff:              },
               "values": {
                   "WoS": {
  -                    "CI95_lower": 97,
  -                    "CI95_upper": 100,
  -                    "estimate_lower": 100,
  -                    "estimate_upper": 100
  +                    "CI95_lower": 81,
  +                    "CI95_upper": 96,
  +                    "estimate_lower": 88,
  +                    "estimate_upper": 93
                   },
  -                "raw": 4
  +                "raw": 1
               }
           },
           "mendeley:readers": {
  -            "provenance_url": "http://api.mendeley.com/research/an-analytically-solvable-model-for-rapid-evolution-of-modular-structure/",
  +            "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",
  
positive.code:                     {
                          "id": 3,
                          "name": "Biological Sciences",
                          "value": 70
                      },
                      {
                          "id": 21,
                          "name": "Physics",
                          "value": 14
                      },
                      {
                          "id": 6,
                          "name": "Computer and Information Science",
                          "value": 8
                      }
                  ]
              }
          },
          "mendeley:groups": {
              "provenance_url": "http://api.mendeley.com/research/an-analytically-solvable-model-for-rapid-evolution-of-modular-structure/",
              "static_meta": {
                  "description": "The number of groups who have added the article to their libraries",
                  "display_name": "groups",
  
negative.code:                     "estimate_lower": 98,
                      "estimate_upper": 98
                  },
                  "raw": 32
              }
          },
          "pubmed:pmc_citations": {
              "provenance_url": "http://www.ncbi.nlm.nih.gov/pubmed?linkname=pubmed_pubmed_citedin&from_uid=20807452",
              "static_meta": {
                  "description": "The number of citations by papers in PubMed Central",
                  "display_name": "citations",
                  "icon": "http://www.ncbi.nlm.nih.gov/favicon.ico",
                  "provider": "PubMed Central",
                  "provider_url": "http://pubmed.gov"
              },
              "values": {
                  "WoS": {
                      "CI95_lower": 87,
                      "CI95_upper": 96,
                      "estimate_lower": 93,
                      "estimate_upper": 93
                  },
                  "raw": 5
              }
          }
      },
      "type": "item"
  }
  
  **Articles or Datasets with DOIs** Get metrics and biblio information on the item
  GET /v1/item/doi/10.1186/1756-0500-4-487?key=YOURKEY
  < 200
  {
      "_id": "c5vh88e15ad42z9dmo1h08wi",
      "_rev": "5-e02fab86d760d22e13b8812513b5cce0",
      "aliases": {
          "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.1186/1471-2148-10-266"
          ],
          "pmid": [
              "20807452"
          ],
          "url": [
              "http://www.biomedcentral.com/1471-2148/10/266"
          ]
      },
      "biblio": {
          "authors": "Nyman, Vikberg, Smith, Boev\u00e9",
          "genre": "article",
          "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": true,
      "last_modified": "2012-11-23T22:00:43.085957",
      "metrics": {
          "mendeley:career_stage": {
              "provenance_url": "http://api.mendeley.com/research/common-ecological-speciation-plant-feeding-insects-higher-nematinae-perspective/",
              "static_meta": {
                  "description": "Percent of readers by career stage, for top three career stages (csv, api only)",
                  "display_name": "career stage, top 3 percentages",
                  "icon": "http://www.mendeley.com/favicon.ico",
                  "provider": "Mendeley",
                  "provider_url": "http://www.mendeley.com/"
              },
              "values": {
                  "raw": [
                      {
                          "name": "Ph.D. Student",
                          "value": 31
                      },
                      {
                          "name": "Post Doc",
                          "value": 16
                      },
                      {
                          "name": "Researcher (at an Academic Institution)",
                          "value": 9
                      }
                  ]
              }
          },
          "mendeley:country": {
              "provenance_url": "http://api.mendeley.com/research/common-ecological-speciation-plant-feeding-insects-higher-nematinae-perspective/",
              "static_meta": {
                  "description": "Percent of readers by country, for top three countries (csv, api only)",
                  "display_name": "country, top 3 percentages",
                  "icon": "http://www.mendeley.com/favicon.ico",
                  "provider": "Mendeley",
                  "provider_url": "http://www.mendeley.com/"
              },
              "values": {
                  "raw": [
                      {
                          "name": "United States",
                          "value": 25
                      },
                      {
                          "name": "United Kingdom",
                          "value": 13
                      },
                      {
                          "name": "Brazil",
                          "value": 6
                      }
                  ]
              }
          },
          "mendeley:discipline": {
              "provenance_url": "http://api.mendeley.com/research/common-ecological-speciation-plant-feeding-insects-higher-nematinae-perspective/",
              "static_meta": {
                  "description": "Percent of readers by discipline, for top three disciplines (csv, api only)",
                  "display_name": "discipline, top 3 percentages",
                  "icon": "http://www.mendeley.com/favicon.ico",
                  "provider": "Mendeley",
                  "provider_url": "http://www.mendeley.com/"
              },
              "values": {
                  "raw": [
                      {
                          "id": 3,
                          "name": "Biological Sciences",
                          "value": 78
                      },
                      {
                          "id": 12,
                          "name": "Environmental Sciences",
                          "value": 13
                      },
                      {
                          "id": 7,
                          "name": "Earth Sciences",
                          "value": 3
                      }
                  ]
              }
          },
          "mendeley:groups": {
              "provenance_url": "http://api.mendeley.com/research/common-ecological-speciation-plant-feeding-insects-higher-nematinae-perspective/",
              "static_meta": {
                  "description": "The number of groups who have added the article to their libraries",
                  "display_name": "groups",
                  "icon": "http://www.mendeley.com/favicon.ico",
                  "provider": "Mendeley",
                  "provider_url": "http://www.mendeley.com/"
              },
              "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",
                  "icon": "http://www.mendeley.com/favicon.ico",
                  "provider": "Mendeley",
                  "provider_url": "http://www.mendeley.com/"
              },
              "values": {
                  "WoS": {
                      "CI95_lower": 94,
                      "CI95_upper": 99,
                      "estimate_lower": 98,
                      "estimate_upper": 98
                  },
                  "raw": 32
              }
          }
      },
      "type": "item"
  }
  
  **GitHub software repositories** Get metrics and biblio information on the item
  GET /v1/item/github/egonw,cdk?key=YOURKEY
  < 200
  < Content-Type: application/json
  {
      "_id": "k58vwwqzxxj0dq7ao4lchaxp",
      "_rev": "7-ba3054fac4f85f22a37bd3b88b102b34",
      "aliases": {
          "github": [
              "egonw,cdk"
          ],
          "title": [
              "cdk"
          ],
          "url": [
              "https://github.com/egonw/cdk"
          ]
      },
      "biblio": {
          "create_date": "2009-07-29T11:52:22Z",
          "description": "The Chemistry Development Kit",
          "genre": "software",
          "h1": "\n            ",
          "last_push_date": "2012-08-02T13:05:20Z",
          "owner": "egonw",
          "title": "cdk",
          "url": "https://github.com/egonw/cdk"
      },
      "created": "2012-08-02T10:40:10.941687",
      "currently_updating": false,
      "last_modified": "2012-09-26T00:30:45.049499",
      "metrics": {
          "github:forks": {
              "provenance_url": "https://github.com/egonw/cdk/network/members",
              "static_meta": {
                  "description": "The number of people who have forked the GitHub repository",
                  "display_name": "forks",
                  "icon": "https://github.com/fluidicon.png",
                  "provider": "GitHub",
                  "provider_url": "http://github.com"
              },
              "values": {
                  "raw": 28
              }
          },
          "github:watchers": {
              "provenance_url": "https://github.com/egonw/cdk/watchers",
              "static_meta": {
                  "description": "The number of people who are watching the GitHub repository",
                  "display_name": "watchers",
                  "icon": "https://github.com/fluidicon.png",
                  "provider": "GitHub",
                  "provider_url": "http://github.com"
              },
              "values": {
                  "raw": 31
              }
          }
      },
      "providersWithMetricsCount": 10,
      "type": "item"
  }
  
  **SlideShare slides** Get metrics and biblio information on the item
  GET /v1/item/url/http://www.slideshare.net/cavlec/who-owns-our-work?key=YOURKEY
  < 200
  < Content-Type: application/json
  {
      "_id": "8yxrcdddi6npbhd675r7mqf1",
      "_rev": "7-9d98f382d10c8d5b63430dadfb69ec68",
      "aliases": {
          "title": [
              "Who owns our work?"
          ],
          "url": [
              "http://www.slideshare.net/cavlec/who-owns-our-work"
          ]
      },
      "biblio": {
          "created": "Tue Apr 13 03:42:30 -0500 2010",
          "genre": "slides",
          "h1": "Who owns our work?",
          "repository": "Slideshare",
          "title": "Who owns our work?",
          "username": "cavlec"
      },
      "created": "2012-08-14T19:59:21.805081",
      "currently_updating": false,
      "last_modified": "2012-08-14T19:59:51.597151",
      "metrics": {
          "slideshare:downloads": {
              "provenance_url": "http://www.slideshare.net/cavlec/who-owns-our-work",
              "static_meta": {
                  "description": "The number of times the presentation has been downloaded",
                  "display_name": "downloads",
                  "icon": "http://www.slideshare.net/favicon.ico",
                  "provider": "Slideshare",
                  "provider_url": "http://www.slideshare.net/"
              },
              "values": {
                  "raw": 36
              }
          },
          "slideshare:favorites": {
              "provenance_url": "http://www.slideshare.net/cavlec/who-owns-our-work",
              "static_meta": {
                  "description": "The number of times the presentation has been favorited",
                  "display_name": "favorites",
                  "icon": "http://www.slideshare.net/favicon.ico",
                  "provider": "Slideshare",
                  "provider_url": "http://www.slideshare.net/"
              },
              "values": {
                  "raw": 4
              }
          },
          "slideshare:views": {
              "provenance_url": "http://www.slideshare.net/cavlec/who-owns-our-work",
              "static_meta": {
                  "description": "The number of times the presentation has been viewed",
                  "display_name": "views",
                  "icon": "http://www.slideshare.net/favicon.ico",
                  "provider": "Slideshare",
                  "provider_url": "http://www.slideshare.net/"
              },
              "values": {
                  "raw": 2409
              }
          },
          "topsy:tweets": {
              "provenance_url": "http://topsy.com/www.slideshare.net/cavlec/who-owns-our-work?utm_source=otter",
              "static_meta": {
                  "description": "Number of times the item has been tweeted",
                  "display_name": "tweets",
                  "icon": "http://twitter.com/phoenix/favicon.ico",
                  "provider": "Topsy",
                  "provider_url": "http://www.topsy.com/"
              },
              "values": {
                  "raw": 3
              }
          }
      },
      "providersWithMetricsCount": 11,
      "type": "item"
  }
  
  **Any url** Get metrics and biblio information on the item
  GET /v1/item/url/http://www.carlboettiger.info?key=YOURKEY
  < 200
  < Content-Type: application/json
  {
      "_id": "uosyks697znfvx9fb7nnmjav",
      "_rev": "5-4e2923c9aefd29fbde630b30f9b978e2",
      "aliases": {
          "url": [
              "http://www.carlboettiger.info"
          ]
      },
      "biblio": {
          "genre": "webpage",
          "h1": "Carl Boettiger",
          "title": "Carl Boettiger"
      },
      "created": "2012-10-02T10:09:50.051559",
      "currently_updating": false,
      "last_modified": "2012-10-02T20:14:00.848206",
      "metrics": {
          "facebook:likes": {
              "provenance_url": "",
              "static_meta": {
                  "description": "Number of users who Liked a post about the item",
                  "display_name": "likes",
                  "icon": "http://www.facebook.com/favicon.ico",
                  "provider": "Facebook",
                  "provider_url": "http://www.facebook.com/"
              },
              "values": {
                  "raw": 1
              }
          },
          "topsy:tweets": {
              "provenance_url": "http://topsy.com/www.carlboettiger.info?utm_source=otter",
              "static_meta": {
                  "description": "Number of times the item has been tweeted",
                  "display_name": "tweets",
                  "icon": "http://twitter.com/phoenix/favicon.ico",
                  "provider": "Topsy",
                  "provider_url": "http://www.topsy.com/"
              },
              "values": {
                  "raw": 4
              }
          }
      },
      "type": "item"
  }
  
  
  --
  work with collections 
  
  Collections are groups of items.  
  Collections can be viewed in the webapp as http://impactstory.org/collection/`_id`.  For example: [http://impactstory.org/collection/kn5auf](http://impactstory.org/collection/kn5auf).
  --
  Create a collection of items.  
  Data payload should contain a list of [namespace, id] pairs and a collection title, as JSON.  
  
  `{"aliases": [["doi", "10.1371/journal.pcbi.1000361"], ["url", "http://www.carlboettiger.info/"]], "title": "My Collection"}`
  
  Returns a collection object with a collection `_id` and status code `201`.  
  POST /v1/collection?key=YOURKEY
  > Content-Type: application/json;charset=utf-8
  {"aliases": [["doi", "10.1371/journal.pcbi.1000361"], ["url", "http://www.carlboettiger.info/"]], "title": "My Collection"}
  < 201
  < Content-Type: application/json
  {
      "collection": {
          "_id": "hr5mxg",
          "_rev": "1-63390a28dc923bb2df6c49aa2080fa6a",
          "alias_tiids": {
              "doi:10.1371/journal.pcbi.1000361": "8kgmw95as0o47piqee09k7of",
              "url:http://www.carlboettiger.info/": "1b2f4fc2bea711e1bdf912313d1a5e63"
          },
          "created": "2012-11-23T21:04:58.910101",
          "ip_address": "",
          "title": "My Collection",
          "type": "collection"
      },
  }
  
  Get the items and metadata associated with a collection.  Returns `210` when some items are currently updating, else `200`.
  GET /v1/collection/kn5auf?key=YOURKEY
  < 200
  < Content-Type: application/json
  {
      "_id": "kn5auf",
      "_rev": "15-0d1e7171fb34eefcfcdd275131b25a16",
      "created": "2012-06-25T09:21:12.673503",
      "title": "My Collection",
      "type": "collection"
      "items": [
          {
              "_id": "ql992e8bavpa1xdmncddlkee",
              "_rev": "179-6444a627050dfa65d3c3ed119e1db0eb",
              "type": "item",
              "created": "2012-08-07T16:34:59.689481",
              "currently_updating": false,
              "aliases": {..},
              "biblio": {..},
              "metrics": {..}
          }
      ]
  }
  
  -- metadata --
  
  Get metadata for the providers that ImpactStory uses to obtain metrics, aliases, and bibliometric data.
  GET /v1/provider?key=YOURKEY
  < 200
  < Content-Type: application/json
  {
      "citeulike": {
          "descr": "CiteULike is a free service to help you to store, organise and share the scholarly papers you are reading.",
          "metrics": {
              "bookmarks": {
                  "description": "Number of users who have bookmarked this item.",
                  "display_name": "bookmarks",
                  "icon": "http://citeulike.org/favicon.ico",
                  "provider": "CiteULike",
                  "provider_url": "http://www.citeulike.org/"
              }
          },
          "provides_aliases": false,
          "provides_metrics": true,
          "url": "http://www.citeulike.org/"
      },
      {
      "wikipedia": {
          "descr": "The free encyclopedia that anyone can edit.",
          "metrics": {
              "mentions": {
                  "description": "The number of Wikipedia articles that mentioned this object.",
                  "display_name": "mentions",
                  "icon": "http://wikipedia.org/favicon.ico",
                  "provider": "Wikipedia",
                  "provider_url": "http://www.wikipedia.org/"
              }
          },
          "provides_aliases": false,
          "provides_metrics": true,
          "url": "http://www.wikipedia.org/"
      }
  }
  
  