API_documentation_UNIXshell/Metrics_API.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Metrics Search Requests\n",
    "This notebook explains how to retrieve citation data and other metrics for a given bibcode(s).\n",
    "\n",
    "The base URL for metrics queries is `https://api.adsabs.harvard.edu/v1/metrics`. \n",
    "\n",
    "All queries to the API must include an HTTP header that specifies your API access token, e.g.\n",
    "\n",
    "`curl -H 'Authorization: Bearer <token>' ...`\n",
    "\n",
    "In the examples below, {token_header} is used to denote `-H 'Authorization: Bearer <token>'`, where `<token>` is your personal API access token as described in the top-level [README](https://github.com/adsabs/adsabs-dev-api/blob/master/README.md).\n",
    "\n",
    "Note: the API examples in this notebook generally assume you're using `curl` statements from the shell command line--you'll see `%%bash` at the top of a cell if its contents should be run in the shell instead of in Python. Guidelines for translating bash `curl` statements into Python can be found in the [converting curl to python notebook](Converting_curl_to_python.ipynb). If you prefer, you can use the unofficial Python package instead; see the top-level [README](https://github.com/adsabs/adsabs-dev-api/blob/master/README.md) for more information."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Sending a metrics request\n",
    "All metrics requests use the default HTTP method POST. POST requests require a payload to be specified using the `-d` flag. For metrics, this payload will be JSON formatted, with the key `bibcodes` and a value set to a comma-separated list of the bibcodes to retrieve metrics for. For example:\n",
    "\n",
    "`curl {token_header} https://api.adsabs.harvard.edu/v1/metrics -X POST -d '{\"bibcodes\": [\"bibcode1\",\"bibcode2\"]}'`\n",
    "\n",
    "You can request a specific set of metrics by adding the `types` parameter in the JSON payload. For example:\n",
    "\n",
    "`curl {token_header} -H \"Content-Type: application/json\" https://api.adsabs.harvard.edu/v1/metrics -X POST -d '{\"bibcodes\": [\"bibcode1\",\"bibcode2\"], \"types\":[\"basic\"]}'`\n",
    "\n",
    "This will return just the basic statistics for a set of bibcodes. The following values are allowed for the `types` list:\n",
    "\n",
    "  * 'basic': publication and usage stats (all papers, and just refereed papers)\n",
    "  * 'citations': citation stats\n",
    "  * 'indicators': indicators, like the h-index, g-index, m-index etc etc\n",
    "  * 'histograms': publication, citation, reads and downloads histograms\n",
    "  * 'timeseries': time series for a set of indicators\n",
    "  \n",
    "To only return a specific histogram, add a `histograms` parameter to the JSON payload, specifying that histogram. For example:\n",
    "\n",
    "`curl {token_header} -H \"Content-Type: application/json\" https://api.adsabs.harvard.edu/v1/metrics -X POST -d '{\"bibcodes\":[\"bibcode1\",\"bibcode2\"], \"types\":[\"histograms\"], \"histograms\":[\"publications\"]}'`\n",
    "\n",
    "to get just the publications histogram. "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Response from a metrics request\n",
    "The service returns JSON with attributes determined by the contents of the `types` list (no such list means that everything gets returned). It always contains an attribute `skipped bibcodes`, which is a list of bibcodes for which no metrics data could be found. The following JSON attributes are returned by each type:\n",
    "\n",
    "  * 'basic': 'basic stats' and 'basic stats refereed'\n",
    "  * 'citations': 'citation stats' and 'citation stats refereed'\n",
    "  * 'indicators': 'indicators' and 'indicators refereed'\n",
    "  * 'histograms': 'histograms'\n",
    "  * 'timeseries': 'time series'\n",
    "\n",
    "Each of these attributes contains specific data elements. The following sections shows what each type contains (each bullet point is an attribute name, or JSON key).\n",
    "\n",
    "#### 'basic stats' and 'basic stats refereed'\n",
    "  * number of papers\n",
    "  * normalized paper count\n",
    "  * median number of reads\n",
    "  * average number of reads\n",
    "  * total number of reads\n",
    "  * normalized number of reads\n",
    "  * median number of downloads\n",
    "  * average number of downloads\n",
    "  * total number of downloads\n",
    "  * normalized number of downloads\n",
    "  \n",
    "#### 'citation stats' and 'citation stats refereed'\n",
    "  * number of citing papers\n",
    "  * median number of citations\n",
    "  * average number of citations\n",
    "  * total number of citations\n",
    "  * normalized number of citations\n",
    "  * median number of refereed citations\n",
    "  * average number of refereed citations\n",
    "  * total number of refereed citations\n",
    "  * normalized number of refereed citations\n",
    "  * number of self-citations\n",
    "\n",
    "#### 'indicators'\n",
    "  * i10\n",
    "  * i100\n",
    "  * h\n",
    "  * m\n",
    "  * g\n",
    "  * read10\n",
    "  * tori\n",
    "\n",
    "#### 'histograms'\n",
    "For all histograms, the actual histogram values are stored as follows:\n",
    "```\n",
    "    {\n",
    "\t    \"histogram name\": {year: value, year: value, ...}\n",
    "\t}\n",
    "```\n",
    "where values can be either integers or floats, depending on the type of histograms. The histogram name is an attribute of the histogram type. For example, the `publications` type has 4 separate histograms: `all publications`, `refereed publications`, `all publications normalized` and `refereed publications normalized`, which are organized as follows in the JSON output:\n",
    "```\n",
    "    {\n",
    "\t    \"histograms\":  {\n",
    "\t\t\t\"publications\": {\n",
    "\t\t\t\t\"all publications\": {},\n",
    "\t\t\t\t\"refereed publications\": {},\n",
    "\t\t\t\t\"all publications normalized\": {},\n",
    "\t\t\t\t\"refereed publications normalized\": {},\n",
    "\t\t\t\n",
    "\t\t\t}\n",
    "\t\t}\n",
    "\t}\n",
    "```\n",
    "The following lists all histogram types and the names of the actual histograms stored in them:\n",
    "\n",
    "  * 'publications': 'all publications', 'refereed publications', 'all publications normalized', 'refereed publications normalized'\n",
    "  * 'reads': 'all reads', 'refereed reads', 'all reads normalized', 'refereed reads normalized'\n",
    "  * 'downloads': 'all downloads', 'refereed downloads', 'all downloads normalized', 'refereed downloads normalized'\n",
    "  * 'citations': 'refereed to refereed', 'nonrefereed to refereed', 'refereed to nonrefereed', 'nonrefereed to nonrefereed', 'refereed to refereed normalized', 'nonrefereed to refereed normalized', 'refereed to nonrefereed normalized', 'nonrefereed to nonrefereed normalized'\n",
    "\n",
    "Note that 'refereed reads' means: 'number of reads for the refereed publications in the set'.\n",
    "\n",
    "#### 'timeseries'\n",
    "The `timeseries` attribute contains time series data for: `h`, `g`, `i10`, `i100`, `read10` and `tori`. The output is structured as\n",
    "```\n",
    "    {\n",
    "\t\t\"time series\": {\n",
    "\t\t\t\"h\": { values },\n",
    "\t\t\t\"g\": { values },\n",
    "\t\t\t\"i10\": { values },\n",
    "\t\t\t\"i100\": { values },\n",
    "\t\t\t\"read10\": { values },\n",
    "\t\t\t\"tori\": { values },\n",
    "\t\t\n",
    "\t\t}\n",
    "\t}\n",
    "```\n",
    "where the 'values' are organized in the same way as for the histograms: \n",
    "```\n",
    "    {\n",
    "\t    \"indicator name\": {year: value, year: value, ...}\n",
    "\t}\n",
    "```"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "### Examples"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{\n",
      "    \"basic stats\": {\n",
      "        \"average number of downloads\": 8134.0,\n",
      "        \"average number of reads\": 19644.0,\n",
      "        \"median number of downloads\": 8134.0,\n",
      "        \"median number of reads\": 19644.0,\n",
      "        \"normalized paper count\": 0.058823529411764705,\n",
      "        \"number of papers\": 1,\n",
      "        \"recent number of downloads\": 144,\n",
      "        \"recent number of reads\": 446,\n",
      "        \"total number of downloads\": 8134,\n",
      "        \"total number of reads\": 19644\n",
      "    },\n",
      "    \"basic stats refereed\": {\n",
      "        \"average number of downloads\": 8134.0,\n",
      "        \"average number of reads\": 19644.0,\n",
      "        \"median number of downloads\": 8134.0,\n",
      "        \"median number of reads\": 19644.0,\n",
      "        \"normalized paper count\": 0.058823529411764705,\n",
      "        \"number of papers\": 1,\n",
      "        \"recent number of downloads\": 144,\n",
      "        \"recent number of reads\": 446,\n",
      "        \"total number of downloads\": 8134,\n",
      "        \"total number of reads\": 19644\n",
      "    },\n",
      "    \"citation stats\": {\n",
      "        \"average number of citations\": 8730.0,\n",
      "        \"average number of refereed citations\": 7501.0,\n",
      "        \"median number of citations\": 8730.0,\n",
      "        \"median number of refereed citations\": 7501.0,\n",
      "        \"normalized number of citations\": 513.5294117647059,\n",
      "        \"normalized number of refereed citations\": 441.2352941176471,\n",
      "        \"number of citing papers\": 8730,\n",
      "        \"number of self-citations\": 0,\n",
      "        \"self-citations\": [],\n",
      "        \"total number of citations\": 8730,\n",
      "        \"total number of refereed citations\": 7501\n",
      "    },\n",
      "    \"citation stats refereed\": {\n",
      "        \"average number of citations\": 8730.0,\n",
      "        \"average number of refereed citations\": 7501.0,\n",
      "        \"median number of citations\": 8730.0,\n",
      "        \"median number of refereed citations\": 7501.0,\n",
      "        \"normalized number of citations\": 513.5294117647059,\n",
      "        \"normalized number of refereed citations\": 441.2352941176471,\n",
      "        \"number of citing papers\": 8730,\n",
      "        \"number of self-citations\": 0,\n",
      "        \"total number of citations\": 8730,\n",
      "        \"total number of refereed citations\": 7501\n",
      "    },\n",
      "    \"histograms\": {\n",
      "        \"citations\": {\n",
      "            \"nonrefereed to nonrefereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"nonrefereed to nonrefereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"nonrefereed to refereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 2,\n",
      "                \"2003\": 95,\n",
      "                \"2004\": 148,\n",
      "                \"2005\": 237,\n",
      "                \"2006\": 152,\n",
      "                \"2007\": 101,\n",
      "                \"2008\": 75,\n",
      "                \"2009\": 70,\n",
      "                \"2010\": 52,\n",
      "                \"2011\": 35,\n",
      "                \"2012\": 47,\n",
      "                \"2013\": 36,\n",
      "                \"2014\": 30,\n",
      "                \"2015\": 34,\n",
      "                \"2016\": 35,\n",
      "                \"2017\": 39,\n",
      "                \"2018\": 41\n",
      "            },\n",
      "            \"nonrefereed to refereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0.11764705882352941,\n",
      "                \"2003\": 5.588235294117634,\n",
      "                \"2004\": 8.705882352941153,\n",
      "                \"2005\": 13.941176470588193,\n",
      "                \"2006\": 8.94117647058821,\n",
      "                \"2007\": 5.941176470588221,\n",
      "                \"2008\": 4.411764705882344,\n",
      "                \"2009\": 4.117647058823522,\n",
      "                \"2010\": 3.058823529411761,\n",
      "                \"2011\": 2.0588235294117645,\n",
      "                \"2012\": 2.7647058823529385,\n",
      "                \"2013\": 2.117647058823529,\n",
      "                \"2014\": 1.7647058823529413,\n",
      "                \"2015\": 2.0,\n",
      "                \"2016\": 2.0588235294117645,\n",
      "                \"2017\": 2.2941176470588225,\n",
      "                \"2018\": 2.4117647058823515\n",
      "            },\n",
      "            \"refereed to nonrefereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"refereed to nonrefereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"refereed to refereed\": {\n",
      "                \"2001\": 1,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 379,\n",
      "                \"2004\": 992,\n",
      "                \"2005\": 1026,\n",
      "                \"2006\": 997,\n",
      "                \"2007\": 667,\n",
      "                \"2008\": 533,\n",
      "                \"2009\": 462,\n",
      "                \"2010\": 411,\n",
      "                \"2011\": 362,\n",
      "                \"2012\": 342,\n",
      "                \"2013\": 317,\n",
      "                \"2014\": 282,\n",
      "                \"2015\": 250,\n",
      "                \"2016\": 204,\n",
      "                \"2017\": 187,\n",
      "                \"2018\": 89\n",
      "            },\n",
      "            \"refereed to refereed normalized\": {\n",
      "                \"2001\": 0.058823529411764705,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 22.29411764705875,\n",
      "                \"2004\": 58.35294117647198,\n",
      "                \"2005\": 60.35294117647209,\n",
      "                \"2006\": 58.64705882353082,\n",
      "                \"2007\": 39.23529411764736,\n",
      "                \"2008\": 31.352941176470484,\n",
      "                \"2009\": 27.176470588235205,\n",
      "                \"2010\": 24.176470588235215,\n",
      "                \"2011\": 21.294117647058755,\n",
      "                \"2012\": 20.117647058823465,\n",
      "                \"2013\": 18.647058823529353,\n",
      "                \"2014\": 16.588235294117595,\n",
      "                \"2015\": 14.705882352941131,\n",
      "                \"2016\": 11.999999999999964,\n",
      "                \"2017\": 10.999999999999968,\n",
      "                \"2018\": 5.235294117647047\n",
      "            }\n",
      "        },\n",
      "        \"reads\": {\n",
      "            \"all reads\": {\n",
      "                \"1996\": 0,\n",
      "                \"1997\": 0,\n",
      "                \"1998\": 0,\n",
      "                \"1999\": 0,\n",
      "                \"2000\": 0,\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 839,\n",
      "                \"2004\": 1999,\n",
      "                \"2005\": 1838,\n",
      "                \"2006\": 1909,\n",
      "                \"2007\": 1719,\n",
      "                \"2008\": 1405,\n",
      "                \"2009\": 1243,\n",
      "                \"2010\": 1355,\n",
      "                \"2011\": 1368,\n",
      "                \"2012\": 1348,\n",
      "                \"2013\": 929,\n",
      "                \"2014\": 919,\n",
      "                \"2015\": 743,\n",
      "                \"2016\": 797,\n",
      "                \"2017\": 787,\n",
      "                \"2018\": 446\n",
      "            },\n",
      "            \"all reads normalized\": {\n",
      "                \"1996\": 0.0,\n",
      "                \"1997\": 0.0,\n",
      "                \"1998\": 0.0,\n",
      "                \"1999\": 0.0,\n",
      "                \"2000\": 0.0,\n",
      "                \"2001\": 0.0,\n",
      "                \"2002\": 0.0,\n",
      "                \"2003\": 49.35294117647059,\n",
      "                \"2004\": 117.58823529411765,\n",
      "                \"2005\": 108.11764705882354,\n",
      "                \"2006\": 112.29411764705883,\n",
      "                \"2007\": 101.11764705882354,\n",
      "                \"2008\": 82.6470588235294,\n",
      "                \"2009\": 73.11764705882354,\n",
      "                \"2010\": 79.70588235294117,\n",
      "                \"2011\": 80.47058823529412,\n",
      "                \"2012\": 79.29411764705883,\n",
      "                \"2013\": 54.64705882352941,\n",
      "                \"2014\": 54.05882352941177,\n",
      "                \"2015\": 43.705882352941174,\n",
      "                \"2016\": 46.88235294117647,\n",
      "                \"2017\": 46.294117647058826,\n",
      "                \"2018\": 26.235294117647058\n",
      "            },\n",
      "            \"refereed reads\": {\n",
      "                \"1996\": 0,\n",
      "                \"1997\": 0,\n",
      "                \"1998\": 0,\n",
      "                \"1999\": 0,\n",
      "                \"2000\": 0,\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 839,\n",
      "                \"2004\": 1999,\n",
      "                \"2005\": 1838,\n",
      "                \"2006\": 1909,\n",
      "                \"2007\": 1719,\n",
      "                \"2008\": 1405,\n",
      "                \"2009\": 1243,\n",
      "                \"2010\": 1355,\n",
      "                \"2011\": 1368,\n",
      "                \"2012\": 1348,\n",
      "                \"2013\": 929,\n",
      "                \"2014\": 919,\n",
      "                \"2015\": 743,\n",
      "                \"2016\": 797,\n",
      "                \"2017\": 787,\n",
      "                \"2018\": 446\n",
      "            },\n",
      "            \"refereed reads normalized\": {\n",
      "                \"1996\": 0.0,\n",
      "                \"1997\": 0.0,\n",
      "                \"1998\": 0.0,\n",
      "                \"1999\": 0.0,\n",
      "                \"2000\": 0.0,\n",
      "                \"2001\": 0.0,\n",
      "                \"2002\": 0.0,\n",
      "                \"2003\": 49.35294117647059,\n",
      "                \"2004\": 117.58823529411765,\n",
      "                \"2005\": 108.11764705882354,\n",
      "                \"2006\": 112.29411764705883,\n",
      "                \"2007\": 101.11764705882354,\n",
      "                \"2008\": 82.6470588235294,\n",
      "                \"2009\": 73.11764705882354,\n",
      "                \"2010\": 79.70588235294117,\n",
      "                \"2011\": 80.47058823529412,\n",
      "                \"2012\": 79.29411764705883,\n",
      "                \"2013\": 54.64705882352941,\n",
      "                \"2014\": 54.05882352941177,\n",
      "                \"2015\": 43.705882352941174,\n",
      "                \"2016\": 46.88235294117647,\n",
      "                \"2017\": 46.294117647058826,\n",
      "                \"2018\": 26.235294117647058\n",
      "            }\n",
      "        }\n",
      "    },\n",
      "    \"skipped bibcodes\": []\n",
      "}\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current\n",
      "                                 Dload  Upload   Total   Spent    Left  Speed\n",
      "\r",
      "  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0\r",
      "  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0\r",
      "100  6007  100  5970  100    37   5970     37  0:00:01 --:--:--  0:00:01 24518\n"
     ]
    }
   ],
   "source": [
    "%%bash\n",
    "token=\"your-token-here\"\n",
    "# get all metrics for a single bibcode\n",
    "curl -H \"Authorization: Bearer $token\" -H \"Content-Type: application/json\" \\\n",
    "    https://api.adsabs.harvard.edu/v1/metrics -X POST -d '{\"bibcodes\": [\"2003ApJS..148..175S\"]}' | python -m json.tool "
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{\n",
      "    \"basic stats\": {\n",
      "        \"average number of downloads\": 7555.0,\n",
      "        \"average number of reads\": 18185.5,\n",
      "        \"median number of downloads\": 7555.0,\n",
      "        \"median number of reads\": 18185.5,\n",
      "        \"normalized paper count\": 0.10427807486631016,\n",
      "        \"number of papers\": 2,\n",
      "        \"recent number of downloads\": 240,\n",
      "        \"recent number of reads\": 759,\n",
      "        \"total number of downloads\": 15110,\n",
      "        \"total number of reads\": 36371\n",
      "    },\n",
      "    \"basic stats refereed\": {\n",
      "        \"average number of downloads\": 7555.0,\n",
      "        \"average number of reads\": 18185.5,\n",
      "        \"median number of downloads\": 7555.0,\n",
      "        \"median number of reads\": 18185.5,\n",
      "        \"normalized paper count\": 0.10427807486631016,\n",
      "        \"number of papers\": 2,\n",
      "        \"recent number of downloads\": 240,\n",
      "        \"recent number of reads\": 759,\n",
      "        \"total number of downloads\": 15110,\n",
      "        \"total number of reads\": 36371\n",
      "    },\n",
      "    \"skipped bibcodes\": []\n",
      "}\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current\n",
      "                                 Dload  Upload   Total   Spent    Left  Speed\n",
      "\r",
      "  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0\r",
      "100   851  100   772  100    79    772     79  0:00:01 --:--:--  0:00:01  3976\n"
     ]
    }
   ],
   "source": [
    "%%bash\n",
    "token=\"your-token-here\"\n",
    "# get basic metrics for multiple bibcodes\n",
    "curl -H \"Authorization: Bearer $token\" -H \"Content-Type: application/json\" \\\n",
    "    https://api.adsabs.harvard.edu/v1/metrics \\\n",
    "    -X POST -d '{\"bibcodes\": [\"2003ApJS..148..175S\", \"2007ApJS..170..377S\"], \"types\":[\"basic\"]}' | python -m json.tool"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 3,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "{\n",
      "    \"histograms\": {\n",
      "        \"citations\": {\n",
      "            \"nonrefereed to nonrefereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"nonrefereed to nonrefereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"nonrefereed to refereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 2,\n",
      "                \"2003\": 95,\n",
      "                \"2004\": 148,\n",
      "                \"2005\": 238,\n",
      "                \"2006\": 273,\n",
      "                \"2007\": 294,\n",
      "                \"2008\": 239,\n",
      "                \"2009\": 184,\n",
      "                \"2010\": 119,\n",
      "                \"2011\": 85,\n",
      "                \"2012\": 83,\n",
      "                \"2013\": 66,\n",
      "                \"2014\": 53,\n",
      "                \"2015\": 57,\n",
      "                \"2016\": 56,\n",
      "                \"2017\": 74,\n",
      "                \"2018\": 73\n",
      "            },\n",
      "            \"nonrefereed to refereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0.11764705882352941,\n",
      "                \"2003\": 5.588235294117634,\n",
      "                \"2004\": 8.705882352941153,\n",
      "                \"2005\": 13.986631016042738,\n",
      "                \"2006\": 14.441176470588152,\n",
      "                \"2007\": 14.713903743315441,\n",
      "                \"2008\": 11.866310160427789,\n",
      "                \"2009\": 9.299465240641725,\n",
      "                \"2010\": 6.104278074866325,\n",
      "                \"2011\": 4.331550802139039,\n",
      "                \"2012\": 4.401069518716577,\n",
      "                \"2013\": 3.4812834224598914,\n",
      "                \"2014\": 2.810160427807486,\n",
      "                \"2015\": 3.0454545454545445,\n",
      "                \"2016\": 3.013368983957218,\n",
      "                \"2017\": 3.885026737967912,\n",
      "                \"2018\": 3.8663101604278047\n",
      "            },\n",
      "            \"refereed to nonrefereed\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"refereed to nonrefereed normalized\": {\n",
      "                \"2001\": 0,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 0,\n",
      "                \"2004\": 0,\n",
      "                \"2005\": 0,\n",
      "                \"2006\": 0,\n",
      "                \"2007\": 0,\n",
      "                \"2008\": 0,\n",
      "                \"2009\": 0,\n",
      "                \"2010\": 0,\n",
      "                \"2011\": 0,\n",
      "                \"2012\": 0,\n",
      "                \"2013\": 0,\n",
      "                \"2014\": 0,\n",
      "                \"2015\": 0,\n",
      "                \"2016\": 0,\n",
      "                \"2017\": 0,\n",
      "                \"2018\": 0\n",
      "            },\n",
      "            \"refereed to refereed\": {\n",
      "                \"2001\": 1,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 379,\n",
      "                \"2004\": 992,\n",
      "                \"2005\": 1026,\n",
      "                \"2006\": 1438,\n",
      "                \"2007\": 1736,\n",
      "                \"2008\": 1674,\n",
      "                \"2009\": 1120,\n",
      "                \"2010\": 925,\n",
      "                \"2011\": 777,\n",
      "                \"2012\": 651,\n",
      "                \"2013\": 592,\n",
      "                \"2014\": 485,\n",
      "                \"2015\": 423,\n",
      "                \"2016\": 340,\n",
      "                \"2017\": 318,\n",
      "                \"2018\": 151\n",
      "            },\n",
      "            \"refereed to refereed normalized\": {\n",
      "                \"2001\": 0.058823529411764705,\n",
      "                \"2002\": 0,\n",
      "                \"2003\": 22.29411764705875,\n",
      "                \"2004\": 58.35294117647198,\n",
      "                \"2005\": 60.35294117647209,\n",
      "                \"2006\": 78.69251336898593,\n",
      "                \"2007\": 87.82620320855783,\n",
      "                \"2008\": 83.21657754010832,\n",
      "                \"2009\": 57.085561497326964,\n",
      "                \"2010\": 47.54010695187224,\n",
      "                \"2011\": 40.157754010695655,\n",
      "                \"2012\": 34.16310160427841,\n",
      "                \"2013\": 31.147058823529708,\n",
      "                \"2014\": 25.815508021390585,\n",
      "                \"2015\": 22.56951871657767,\n",
      "                \"2016\": 18.181818181818166,\n",
      "                \"2017\": 16.954545454545396,\n",
      "                \"2018\": 8.053475935828889\n",
      "            }\n",
      "        }\n",
      "    },\n",
      "    \"skipped bibcodes\": []\n",
      "}\n"
     ]
    },
    {
     "name": "stderr",
     "output_type": "stream",
     "text": [
      "  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current\n",
      "                                 Dload  Upload   Total   Spent    Left  Speed\n",
      "\r",
      "  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0\r",
      "100   112    0     0  100   112      0    112  0:00:01 --:--:--  0:00:01   235\r",
      "100  2650  100  2538  100   112   2538    112  0:00:01 --:--:--  0:00:01  5567\n"
     ]
    }
   ],
   "source": [
    "%%bash\n",
    "token=\"your-token-here\"\n",
    "# get data for a single histogram for multiple bibcodes\n",
    "curl -H \"Authorization: Bearer $token\" -H \"Content-Type: application/json\" \\\n",
    "    https://api.adsabs.harvard.edu/v1/metrics \\\n",
    "    -X POST \\\n",
    "    -d '{\"bibcodes\": [\"2003ApJS..148..175S\", \"2007ApJS..170..377S\"], \"types\":[\"histograms\"], \"histograms\":[\"citations\"]}' \\\n",
    "    | python -m json.tool"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.14"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}