Get INSPIRE paper
cern_inspire_get_paperRead-onlyIdempotent
Fetch one paper's full INSPIRE-HEP record by recid, arXiv ID, or DOI: contributors with affiliations and recorded roles, public attached-document links and identifiers, abstract, publication references, arXiv and DOI identifiers, keywords, subjects, citation counts, linked experiments, texkeys, and whether HEPData holds its numerical tables (record DOI, latest version, table count, hepdata.net link). Also returns ready-made literature queries for the papers citing it and for its references. Large collaboration papers can list thousands of authors; max_authors caps the list while authorCount gives the full number.
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": {
"paper": "<paper>"
},
"name": "cern_inspire_get_paper"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| paper | Yes | INSPIRE recid (e.g. 451647), arXiv ID (1207.7214 or hep-th/9711200, with or without 'arXiv:', a version suffix, or an https://arxiv.org/abs/ or https://arxiv.org/pdf/ prefix), DOI (10.1016/…, with or without 'doi:' or an https://doi.org/ prefix; no * or ? wildcards), an https://inspirehep.net/literature/<recid> URL, or HEPData's ins<recid> form, alone or in an https://www.hepdata.net/record/ins<recid> URL. Up to 256 characters. | |
| max_authors | No | Most contributors to list (nonnegative integer, default 25; values above 500 use 500). Zero lists no contributors. The full count is always in authorCount. | |
| author_offset | No | Zero-based starting position in the normalized contributor list (default 0). Use nextAuthorOffset from the previous page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The max_authors cap applied. | |
| core | No | True when INSPIRE classes the paper as core HEP, when recorded. | |
| date | No | Earliest date INSPIRE records for the paper: YYYY, YYYY-MM, or YYYY-MM-DD. | |
| dois | No | DOIs of the paper. | |
| urls | No | External links INSPIRE records for the paper. | |
| error | No | Present when the call failed. Absent on success. | |
| recid | No | INSPIRE literature record ID. | |
| shown | No | Number of contributors listed. | |
| title | No | Title as text: publisher HTML, JATS, and MathML converted (scripts as _x or ^{xy}), LaTeX left as published. | |
| notice | No | Guidance when the recid asked for was merged into this record, the contributor list was capped, HEPData availability could not be checked, or the paper has more than one HEPData record. | |
| arxivId | No | arXiv identifier, when the paper has one. | |
| authors | No | Contributors in record order from authorOffset, capped at the effective max_authors budget. | |
| hepdata | No | HEPData availability for the paper's numerical tables. | |
| texkeys | No | INSPIRE texkeys (BibTeX citation keys), current first. | |
| abstract | No | Full abstract as text (arXiv-sourced when available): publisher markup converted like title, LaTeX left as published. | |
| citeable | No | INSPIRE citeable flag, when recorded. | |
| keywords | No | Keywords, de-duplicated. | |
| licenses | No | Licences recorded for the paper. | |
| refereed | No | True when published in a refereed venue, when recorded. | |
| subjects | No | INSPIRE subject categories. | |
| documents | No | Public attached-document links in record order; no file contents are fetched. | |
| truncated | No | True when available contributors remain after this page, including a zero-budget page. | |
| inspireUrl | No | The paper on inspirehep.net. | |
| mergedFrom | No | The recid asked for, when INSPIRE had merged that record into this one and redirects it here; cite and query this record by recid. | |
| resolvedAs | No | Which identifier form the paper input was resolved from. | |
| authorCount | No | Upstream contributor count, falling back to the available contributor list length. | |
| citingQuery | No | Literature query for papers citing this one; pass to cern_inspire_search_literature. | |
| experiments | No | Accelerator experiments linked to the paper. | |
| authorOffset | No | Zero-based starting position in the normalized available contributor list. | |
| preprintDate | No | Preprint date, when recorded. | |
| publications | No | Publication references (journal, volume, year, pages). | |
| citationCount | No | Citations INSPIRE counts for the paper. | |
| documentTypes | No | INSPIRE document types. | |
| numberOfPages | No | Page count, when recorded. | |
| reportNumbers | No | Report numbers. | |
| abstractSource | No | Who supplied the abstract (e.g. arXiv, a publisher). | |
| collaborations | No | Collaborations credited on the paper; empty for most non-collaboration papers. | |
| alternateTitles | No | Other titles INSPIRE records (translations, preprint titles), converted to text like title. | |
| arxivCategories | No | arXiv categories of the e-print. | |
| publicationDate | No | Publication (imprint) date, when recorded. | |
| referencesQuery | No | Literature query for this paper's references; pass to cern_inspire_search_literature. | |
| nextAuthorOffset | No | Pass as author_offset to read the next page; absent when no contributors remain or the budget is zero. | |
| citationCountWithoutSelf | No | Citations excluding self-citations, when INSPIRE reports it. |