• Home
  • About
  • Download
  • Explore
  • Data
  • FAQ
  • Help
  • Feedback
API | Linked Data

API Methods

    Authors
  • Get a list of authors
  • Get author by ID
  • Get author by name
  • Get number of authors
  • Get network of similar authors
  • Disciplines
  • Get a list of disciplines
  • Get information of a particular discipline
  • Get number of disciplines
  • Get network of similar disciplines



Scholarometer provides a RESTful web API so that other developers can make use of our crowdsourced data. Select the method on the left panel to see corresponding documentation.

Please add a delay of at least 5 seconds between two consecutive queries.

Try the Tenurometer Demo to see an example of how you could use the API.

Get a list of authors

Description

URL http://scholarometer.indiana.edu/api/authors/
Method GET
Querystring group= Filter by Thomson Reuters Citation Index:
sci (science), ssci (social science), or ahci (arts and humanities)
or by having user-generated discipline tag: usrgen
discipline= Filter by discipline tag
sortby= Sort the list by alphabetical order (name) or by decreasing order of impact measures (h, g, h_m, or h_f)
start= The ordinal number of the first author to return
num= The number of authors to return
Returns 200 OK & XML (scholarometer/authors+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/authors/?sortby=h&start=1&num=2

<?xml version="1.0" encoding="utf-8"?> <authors start="1" num="2" sortby="h" next="http://scholarometer.indiana.edu/api/authors/?discipline=& sortby=h&start=3&num=2"> <author id="f82e96d93f6090127c2effb4aab53643" name="S%20FREUD" metricvalue="183" discipline="psychology">S%20FREUD</author> <author id="04a85de5e9f5286c86f1efce70312104" name="M%20GREENBERG" metricvalue="162" discipline= "medicine%2C%20research%20%26%20experimental">M%20GREENBERG</author> </authors>

Get author by ID

Description

URL http://scholarometer.indiana.edu/api/authors/id/[authorid]
Method GET
Querystring none
Returns 200 OK & XML (scholarometer/author+xml)
404 Not Found

Note

The author ID (authorid) can be obtained in either of the following ways:
  1. The API method Get a list of authors lists authors matched some criteria along with their IDs - stored in attribute id of author tag.
  2. When you query for an author from Scholarometer browser extension, the URL of the citation analysis page will be of the form
http://scholarometer.indiana.edu/cgi-bin/index.cgi?func=query&expr=fc9d53036ece008005852f9eeade2e72
The ID for the queried author is the string in frame.

Example

GET
http://scholarometer.indiana.edu/api/authors/
id/29ed8db74b2bce32fbaa082f263aef0b

<?xml version="1.0" encoding="utf-8"?> <author id="29ed8db74b2bce32fbaa082f263aef0b" lastupdate="2010-05-20 15:49:46"> <names> <name>f%20menczer</name> <name>m%20filippo</name> <name>filippo%20menczer</name> </names> <statistics> <narticles>120</narticles> <ncitations>2834</ncitations> </statistics> <impact> <h>28.0</h> <g>49.0</g> <h_m>17.7667</h_m> <h_f discipline="computer science, artificial intelligence" timestagged="12">1.59864</h_f> <h_f discipline="computer science, information systems" timestagged="5">1.46753</h_f> <h_f discipline="complex systems" timestagged="3">1.45695</h_f> <h_f discipline="agricultural economics & policy" timestagged="1">1.6</h_f> <h_f discipline="computer science, interdisciplinary applications" timestagged="1">1.71788</h_f> <h_f discipline="complex networks" timestagged="1">1.32432</h_f> <h_f discipline="social networks" timestagged="1">1.63636</h_f> </impact> </author>

Get author by name

Description

URL http://scholarometer.indiana.edu/api/authors/name/[name]
Method GET
Querystring none
Returns 200 OK & XML (scholarometer/authors+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/authors/name/p%20bourdieu

<?xml version="1.0" encoding="utf-8"?> <authors queriedname="p bourdieu"> <author id="5314065280a869dd8decb6aa2c14228b" lastupdate="2010-02-02 02:17:07"> <names> <name>p bourdieu</name> </names> <statistics> <narticles>300</narticles> <ncitations>145412</ncitations> </statistics> <impact> <h>155.0</h> <g>298.0</g> <h_m>138.583</h_m> <h_f discipline="anthropology" timestagged="2">9.17895</h_f> <h_f discipline="sociology" timestagged="2">5.90304</h_f> </impact> </author> <author id="80bcadc9e55ede5d31d530d808516433" lastupdate="2010-02-02 12:49:46"> <names> <name>p bourdieu</name> <name>pierre bourdieu</name> </names> <statistics> <narticles>302</narticles> <ncitations>144224</ncitations> </statistics> <impact> <h>157.0</h> <g>298.0</g> <h_m>137.583</h_m> <h_f discipline="sociology" timestagged="2">5.5324</h_f> </impact> </author> </authors>

Get number of authors

Description

URL http://scholarometer.indiana.edu/api/authors/count
Method GET
Querystring group= Filter by Thomson Reuters Citation Index:
sci (science), ssci (social science), or ahci (arts and humanities)
or by having user-generated discipline tag: usrgen
discipline= Filter by discipline tag
recorddate= yyyy-mm-dd
The date the count was based on.
By default: the current date.
Returns 200 OK & XML (scholarometer/authorcount+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/authors/
count?discipline=computer%20science%2C%20information%20systems

<?xml version="1.0" encoding="utf-8"?> <authorcount discipline="computer%20science%2C%20information%20systems" group="" recorddate="2010-05-24">745</authorcount>

Get network of similar authors

Description

URL http://scholarometer.indiana.edu/api/authors/network/[authorid]
Method GET
Querystring edgetype= Specify a way to calculate edge weight, could be:
cosine, dotproduct (default), or binarydotproduct
maxnnodes= Specify maximum number of nodes in the network. Must not exceed 20. Default = 3.
Returns 200 OK & XML (scholarometer/graphml+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/authors/
network/29ed8db74b2bce32fbaa082f263aef0b?maxnnodes=5&edgetype=binarydotproduct

<?xml version="1.0" encoding="utf-8"?> <graphml> <graph edgedefault="undirected"> <key attr.name="name" attr.type="string" for="node" id="name"/> <key attr.name="h" attr.type="string" for="node" id="h"/> <key attr.name="weight" attr.type="string" for="edge" id="weight"/> <node id="f8b5c725f27c0d4ae2fc7e98aa75d89a"> <data key="name">k%20lerman</data> <data key="h">24</data> </node> <node id="29ed8db74b2bce32fbaa082f263aef0b"> <data key="name">f%20menczer</data> <data key="h">28</data> </node> <node id="9fa41776b601e4a552a3a0b3c9c62894"> <data key="name">m%20lenzerini</data> <data key="h">55</data> </node> <node id="2d586683cef1c4bd5fbeab66ed868443"> <data key="name">a%20vespignani</data> <data key="h">39</data> </node> <edge source="29ed8db74b2bce32fbaa082f263aef0b" target="f8b5c725f27c0d4ae2fc7e98aa75d89a" weight="4"/> <edge source="29ed8db74b2bce32fbaa082f263aef0b" target="2d586683cef1c4bd5fbeab66ed868443" weight="5"/> <edge source="29ed8db74b2bce32fbaa082f263aef0b" target="9fa41776b601e4a552a3a0b3c9c62894" weight="2"/> <edge source="2d586683cef1c4bd5fbeab66ed868443" target="f8b5c725f27c0d4ae2fc7e98aa75d89a" weight="3"/> <edge source="2d586683cef1c4bd5fbeab66ed868443" target="9fa41776b601e4a552a3a0b3c9c62894" weight="2"/> <edge source="9fa41776b601e4a552a3a0b3c9c62894" target="f8b5c725f27c0d4ae2fc7e98aa75d89a" weight="2"/> </graph> </graphml>

Get a list of disciplines

Description

URL http://scholarometer.indiana.edu/api/disciplines/
Method GET
Querystring group= Filter by Thomson Reuters Citation Index:
sci (science), ssci (social science), or ahci (arts and humanities)
or by having user-generated discipline tag: usrgen
authorid= Filter by author id
sortby= Sort the list by alphabetical order (name) or
by decreasing order of statistical metric (nauthors, avgh, avgg, avgh_m, or avgh_f)
Returns 200 OK & XML (scholarometer/disciplines+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/disciplines/?sortby=nauthors

<?xml version="1.0" encoding="utf-8"?> <disciplines sortby="nauthors"> <discipline metricvalue="618">information%20systems</discipline> <discipline metricvalue="577">artificial%20intelligence</discipline> ... </disciplines>

Get information of a particular discipline

Description

URL http://scholarometer.indiana.edu/api/disciplines/discipline/[discipline]
Method GET
Querystring none
Returns 200 OK & XML (scholarometer/discipline+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/disciplines/
discipline/computer%20science%2C%20information%20systems

<discipline lastupdate="2010-05-30 00:16:51"> <name>computer%20science%2C%20information%20systems</name> <statistics> <nauthors>752</nauthors> <narticles>62496</narticles> <avgh>17.1037234043</avgh> <avgg>33.5478723404</avgg> <avgh_m>10.3202608022</avgh_m> <avgh_f>0.973868146306</avgh_f> </statistics> <group>sci</group> </discipline>

Get number of disciplines

Description

URL http://scholarometer.indiana.edu/api/disciplines/count
Method GET
Querystring group= Filter by Thomson Reuters Citation Index:
sci (science), ssci (social science), or ahci (arts and humanities)
or by having user-generated discipline tag: usrgen
recorddate= yyyy-mm-dd
The date the count was based on.
By default: the current date.
Returns 200 OK & XML (scholarometer/disciplinecount+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/disciplines/count

<?xml version="1.0" encoding="utf-8"?> <disciplinecount group="" recorddate="2010-06-01">619</disciplinecount>

Get network of similar disciplines

Description

URL http://scholarometer.indiana.edu/api/disciplines/network/[discipline]
Method GET
Querystring edgetype= Specify a way to calculate edge weight, could be:
cosine, dotproduct (default), or binarydotproduct
maxnnodes= Specify maximum number of nodes in the network. Must not exceed 20. Default = 3.
Returns 200 OK & XML (scholarometer/graphml+xml)
404 Not Found

Example

GET
http://scholarometer.indiana.edu/api/disciplines/
network/complex%20systems?maxnnodes=5

<?xml version="1.0" encoding="utf-8"?> <graphml> <graph edgedefault="undirected"> <key attr.name="name" attr.type="string" for="node" id="name"/> <key attr.name="group" attr.type="string" for="node" id="group"/> <key attr.name="nauthors" attr.type="string" for="node" id="nauthors"/> <key attr.name="weight" attr.type="string" for="edge" id="weight"/> <node id="33"> <data key="name">computer%20science%2C%20artificial%20intelligence</data> <data key="group">sci</data> <data key="nauthors">707</data> </node> <node id="301"> <data key="name">complex%20systems</data> <data key="group">usrgen</data> <data key="nauthors">47</data> </node> <node id="294"> <data key="name">complex%20networks</data> <data key="group">usrgen</data> <data key="nauthors">37</data> </node> <node id="36"> <data key="name">computer%20science%2C%20information%20systems</data> <data key="group">sci</data> <data key="nauthors">757</data> </node> <node id="143"> <data key="name">physics%2C%20multidisciplinary</data> <data key="group">sci</data> <data key="nauthors">77</data> </node> <edge source="33" target="301" weight="81"/> <edge source="33" target="36" weight="120"/> <edge source="294" target="301" weight="82"/> <edge source="36" target="301" weight="76"/> <edge source="143" target="294" weight="90"/> </graph> </graphml>

Contents

  • Introduction
  • Sample Resources
  • Links to external datasets
  • Primary Application


Linked Data is a style of publishing and interlinking structured data on the Semantic Web. In the Semantic Web, data is described and linked using a language called RDF (Resource Description Framework). You can use generic RDF browsers (e.g. Tabulator, Disco, OpenLink Browser), RDF crawlers (e.g. SWSE, Swoogle), and query agents (e.g. SemWeb Client Library, SWIC) to explore the data.

Scholarometer publishes crowdsourced data according to the basic principles of Linked Data. The aim is to make information about authors and disciplines based on citation analysis available on the Semantic Web.


Scholarometer assigns URIs (Uniform Resource Identifiers) to authors and disciplines. We implement an HTTP mechanism called content negotiation in order to provide an HTML representation in addition to the RDF representation of a resource. Some example Linked Data URIs, taken from the Scholarometer dataset, are listed below.

URIs of Authors:

http://scholarometer.indiana.edu/resource/author/authorname

Example:

http://scholarometer.indiana.edu/resource/author/f%20menczer

URIs of Disciplines:

http://scholarometer.indiana.edu/resource/discipline/disciplinename

Example:

http://scholarometer.indiana.edu/resource/discipline/computer%20science

(Note that spaces in URLs are encoded as "%20")

Specific Format:

We allow you to specify the desired format of a resource:

RDF/XML: add "data" to the URI after "resource".

http://scholarometer.indiana.edu/resource/data/author/authorname
http://scholarometer.indiana.edu/resource/data/discipline/disciplinename

HTML: add "page" to the URI after "resource".

http://scholarometer.indiana.edu/resource/page/author/authorname
http://scholarometer.indiana.edu/resource/page/discipline/disciplinename

Scholarometer Vocabulary:

We introduce a new RDF vocabulary to represent impact measures that are not represented in existing vocabularies. The new vocabulary is described at:

http://scholarometer.indiana.edu/namespaces/


Linked Data encourages interlinks between different data sources, which enable Semantic Web browsers and crawlers to navigate between them. In Scholarometer, RDF links primarily point to the following data sets using the owl:sameAs property, which indicates that two URIs refer to the same thing:

  • DBpedia: a multi-domain ontology derived from Wikipedia

  • DBLP: bibliographic information about scientific publications

  • Freebase: an open-license database about millions of things from various domains

  • Opencyc: an open-license version of the Cyc Ontology


Linking from your HTML webpage or FOAF profile to Scholarometer data

If you are an author, then a URI may already have been created for you in Scholarometer. You can simply add a link from your webpage or FOAF profile to your impact data. If you are not in Scholarometer, don't worry; just install the Scholarometer browser extension and query yourself. We will then serve you the citation-based impact analysis and generate a URI for you.

The example below shows an RDF link from a FOAF profile to Scholarometer, which allows navigation from your profile to your impact analysis data.

<foaf:Person rdf:about="your_foaf_url">    <owl:sameAs rdf:resource =       "http://scholarometer.indiana.edu.cn/resource/author/your_name"/> </foaf:Person>

Scholarometer © 2009 - CNetS | School of Informatics and Computing | Indiana University Bloomington