Get citation edges
get_citation_edgesHow a set of papers connect: which of them cite which, such as among related papers found earlier or a reading list. Pass 2 to 100 Paper Nexus ids or papernex.us/paper/ links, or DOIs, arXiv ids, PMIDs, PMCIDs or OpenAlex ids, as papers; each paper counts as one lookup. It returns only the citations between the papers given, each as citing and cited ids, with how many of the others each paper cites and is cited by, and the papers linked to none of them. The links come from reference lists (OpenAlex and Semantic Scholar): a link missing is not proof that one paper does not cite the other, and a citation alone does not show that one paper builds on the other. Pass fields to get only the details of each paper you need.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"papers": "<papers>"
},
"name": "get_citation_edges"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fields | No | Only these fields of each paper, to keep the result short; the id always comes back. Leave it out for every field. | |
| papers | Yes | Paper Nexus ids or papernex.us/paper/<id> links, or DOIs, arXiv ids, PMIDs, PMCIDs or OpenAlex ids |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| edges | Yes | Each citation between two of the papers: citing cites cited | |
| papers | Yes | The papers found, in the order given | |
| complete | No | false when some pairs are unchecked | |
| unlinked | No | The papers that cite none of the others and that none cites | |
| not_found | No | The ids that are not Paper Nexus papers, left out | |
| unchecked | No | Pairs whose link is unknown: the citing paper has more than 600 references and the cited one more than 1000 citing papers, so Paper Nexus holds only part of each list | |
| edge_count | No | ||
| identifiers | No | When papers were named by DOI, arXiv id, PMID, PMCID or OpenAlex id: read_as maps each to its Paper Nexus id, and unresolved lists those no Paper Nexus paper has, which were left out |