Export INSPIRE citations
cern_inspire_export_citationsRead-onlyIdempotent
Export INSPIRE-HEP's citation entries for the papers a literature query selects, as BibTeX or LaTeX \bibitem entries (EU or US style), keyed by INSPIRE texkeys and ready to paste into a bibliography. Name specific papers with "recid:451647 or arxiv:1207.7214 or doi:10.1016/…", or export a topic, author, or citing set with any query cern_inspire_search_literature accepts. Up to 50 entries per page; page through larger sets (only the first 10,000 matches are reachable). Entries are INSPIRE's verbatim text (long author lists arrive abbreviated as "First, Name and others").
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": {
"query": "<query>"
},
"name": "cern_inspire_export_citations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting at 1. page × effective size (after clamping) may not exceed 10,000. | |
| size | No | Entries per page (positive integer, default 10; above 50 uses 50). | |
| sort | No | Entry order: relevance (default), mostrecent, or mostcited. | relevance |
| query | Yes | Literature query selecting the papers to cite, narrowed by the same document_types, subjects, year_from and year_to filters as search. Named papers: "recid:451647 or arxiv:1207.7214 or doi:10.1016/j.physletb.2012.08.020". Or a topic ("t higgs and topcite 500+"), an author ("a Edward.Witten.1"), or citing papers ("refersto:recid:451647"). Empty recognized field clauses such as a: or a:"" (including whitespace-only quoted values) are invalid; other syntax is passed through without complete grammar validation. See cern_inspire_list_reference topic search_syntax. | |
| format | No | Entry format: bibtex (default), latex-eu, or latex-us (\bibitem entries in European or US style). | bibtex |
| year_to | No | Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound. | |
| subjects | No | Restrict to INSPIRE subject categories (up to 4). Multiple values must ALL hold, not either. Values: Astrophysics, Phenomenology-HEP, Theory-HEP, Quantum Physics, Unknown, Gravitation and Cosmology, Experiment-HEP, Theory-Nucl, Accelerators, Instrumentation, General Physics, Experiment-Nucl, Math and Math Physics, Condensed Matter, Computing, Lattice, Other, Data Analysis and Statistics. | |
| year_from | No | Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound. | |
| document_types | No | Restrict to INSPIRE document types (up to 4). Multiple values must ALL hold (published + review = published reviews), not either. Values: article, published, conference paper, thesis, review, note, proceedings, lectures, book chapter, book, introductory, activity report, report. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The page size applied. | |
| page | No | The page returned. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of entries on this page. | |
| format | No | The entry format returned. | |
| notice | No | Guidance when size was reduced, nothing matched, the page is past the last or came back empty inside the match count, or more papers follow. | |
| entries | No | Citation entries, in the requested order. | |
| nextPage | No | The page number to request next, when more papers follow within the 10,000-result window. | |
| truncated | No | True when more matched papers follow this page. | |
| appliedFilters | No | Sort and filters applied, or "none". |