Fetch details about the papers cited by this paper (i.e. appearing in this paper's bibliography)
<br><br>
Examples:
<ul>
<li>Let's suppose that the paper in the examples below has 1600 references...</li>
<li><code>https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b/references</code></li>
<ul>
<li>Returns with offset=0, next=100, and data is a list of 100 references.</li>
<li>Each reference has a citedPaper which contains its paperId and title.</li>
</ul>
<li><code>https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b/references?fields=contexts,intents,isInfluential,abstract&offset=200&limit=10</code></li>
<ul>
<li>Returns with offset=200, next=210, and data is a list of 10 references.</li>
<li>Each reference has contexts, intents, isInfluential, and a citedPaper which contains its paperId and abstract.</li>
</ul>
<li><code>https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b/references?fields=authors&offset=1500&limit=500</code></li>
<ul>
<li>Returns with offset=1500, and data is a list of the last 100 references.</li>
<li>Each reference has a citedPaper which contains its paperId plus a list of authors</li>
<li>The authors under each citedPaper has their authorId and name.</li>
</ul>
</ul>
Parameters (4)
fields(string, query, optional)
A comma-separated list of the fields to be returned. See the contents of the <code>data</code> array in Response Schema below for a list of all available fields that can be returned.
If the fields parameter is omitted, only the <code>paperId</code> and <code>title</code> will be returned.
<p>Request fields nested within <code>citedPaper</code> the same way as fields like <code>contexts</code>.<br><br>
Examples:
<ul>
<li><code>fields=contexts,isInfluential</code></li>
<li><code>fields=contexts,title,authors</code></li>
</ul>
limit(integer, query, optional, default: 100)
The maximum number of results to return.<br>
Must be <= 1000
offset(integer, query, optional, default: 0)
Used for pagination. When returning a list of results, start with the element at this position in the list.
paper_id(string, path, required)
The following types of IDs are supported:
<ul>
<li><code><sha></code> - a Semantic Scholar ID, e.g. <code>649def34f8be52c8b66281af98ae884c09aef38b</code></li>
<li><code>CorpusId:<id></code> - a Semantic Scholar numerical ID, e.g. <code>CorpusId:215416146</code></li>
<li><code>DOI:<doi></code> - a <a href="http://doi.org">Digital Object Identifier</a>,
e.g. <code>DOI:10.18653/v1/N18-3011</code></li>
<li><code>ARXIV:<id></code> - <a href="https://arxiv.org/">arXiv.rg</a>, e.g. <code>ARXIV:2106.15928</code></li>
<li><code>MAG:<id></code> - Microsoft Academic Graph, e.g. <code>MAG:112218234</code></li>
<li><code>ACL:<id></code> - Association for Computational Linguistics, e.g. <code>ACL:W12-3903</code></li>
<li><code>PMID:<id></code> - PubMed/Medline, e.g. <code>PMID:19872477</code></li>
<li><code>PMCID:<id></code> - PubMed Central, e.g. <code>PMCID:2323736</code></li>
<li><code>URL:<url></code> - URL from one of the sites listed below, e.g. <code>URL:https://arxiv.org/abs/2106.15928v1</code></li>
</ul>
URLs are recognized from the following sites:
<ul>
<li><a href="https://www.semanticscholar.org/">semanticscholar.org</a></li>
<li><a href="https://arxiv.org/">arxiv.org</a></li>
<li><a href="https://www.aclweb.org">aclweb.org</a></li>
<li><a href="https://www.acm.org/">acm.org</a></li>
<li><a href="https://www.biorxiv.org/">biorxiv.org</a></li>
</ul>
Examples (3)
Basic references requestcurl
curl 'https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references' \
-d '{"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"}'
import requests
resp = requests.get(
"https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references",
json={
'error': 'Paper with id 649def34f8be52c8b66281af98ae884 not found',
},
)
data = resp.json()
import zingu_apis
api = zingu_apis.api("semanticscholar")
result = api.fetch("paper/{paper_id}/references")
for item in result:
print(item)
const body = {
"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"
};
const resp = await fetch("https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references", {
body: JSON.stringify(body),
});
const data = await resp.json();
References with specific fieldscurl
curl 'https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references?fields=title%2Cauthors%2Cyear%2CcitationCount' \
-d '{"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"}'
import requests
resp = requests.get(
"https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references",
params={
'fields': 'title,authors,year,citationCount',
},
json={
'error': 'Paper with id 649def34f8be52c8b66281af98ae884 not found',
},
)
data = resp.json()
import zingu_apis
api = zingu_apis.api("semanticscholar")
result = api.fetch("paper/{paper_id}/references", fields="title,authors,year,citationCount")
for item in result:
print(item)
const body = {
"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"
};
const resp = await fetch("https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references?fields=title%2Cauthors%2Cyear%2CcitationCount", {
body: JSON.stringify(body),
});
const data = await resp.json();
Paginated references requestcurl
curl 'https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references?limit=50&offset=0' \
-d '{"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"}'
import requests
resp = requests.get(
"https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references",
params={
'limit': '50',
'offset': '0',
},
json={
'error': 'Paper with id 649def34f8be52c8b66281af98ae884 not found',
},
)
data = resp.json()
import zingu_apis
api = zingu_apis.api("semanticscholar")
result = api.fetch("paper/{paper_id}/references", limit=50, offset=0)
for item in result:
print(item)
const body = {
"error": "Paper with id 649def34f8be52c8b66281af98ae884 not found"
};
const resp = await fetch("https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884/references?limit=50&offset=0", {
body: JSON.stringify(body),
});
const data = await resp.json();