Search INSPIRE-HEP papers, authors, experiments, HEPData records; get citation metrics and BibTeX.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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").
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:" are invalid; other syntax is passed through without complete grammar validation. See cern_inspire_list_reference topic search_syntax.
Page number, starting at 1. page × size may not exceed 10,000.
Entries per page (1–50, default 10).
Entry order: relevance (default), mostrecent, or mostcited.
Entry format: bibtex (default), latex-eu, or latex-us (\bibitem entries in European or US style).
Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound.
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.
Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound.
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.
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").
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. page × size may not exceed 10,000. |
| size | integer | Entries per page (1–50, default 10). |
| sort | string | Entry order: relevance (default), mostrecent, or mostcited. |
| query* | string | 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:" are invalid; other syntax is passed through without complete grammar validation. See cern_inspire_list_reference topic search_syntax. |
| format | string | Entry format: bibtex (default), latex-eu, or latex-us (\bibitem entries in European or US style). |
| year_to | integer | Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound. |
| subjects | array | 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 | integer | Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound. |
| document_types | array | 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. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. page × size may not exceed 10,000."
},
"size": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Entries per page (1–50, default 10)."
},
"sort": {
"enum": [
"relevance",
"mostrecent",
"mostcited"
],
"type": "string",
"default": "relevance",
"description": "Entry order: relevance (default), mostrecent, or mostcited."
},
"query": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "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:\" are invalid; other syntax is passed through without complete grammar validation. See cern_inspire_list_reference topic search_syntax."
},
"format": {
"enum": [
"bibtex",
"latex-eu",
"latex-us"
],
"type": "string",
"default": "bibtex",
"description": "Entry format: bibtex (default), latex-eu, or latex-us (\\bibitem entries in European or US style)."
},
"year_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound."
},
"subjects": {
"type": "array",
"items": {
"enum": [
"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"
],
"type": "string",
"description": "An INSPIRE subject category."
},
"maxItems": 4,
"description": "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": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound."
},
"document_types": {
"type": "array",
"items": {
"enum": [
"article",
"published",
"conference paper",
"thesis",
"review",
"note",
"proceedings",
"lectures",
"book chapter",
"book",
"introductory",
"activity report",
"report"
],
"type": "string",
"description": "An INSPIRE document type."
},
"maxItems": 4,
"description": "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."
}
},
"additionalProperties": false
}Compute INSPIRE-HEP's citation summary for one author or for any literature query: h-index, citation totals, average citations per paper, and paper counts per citation bucket (0, 1–9, 10–49, 50–99, 100–249, 250–499, 500+), each for all citeable papers and for published papers, plus citations received per year. Pass exactly one of author (a BAI, ORCID, INSPIRE ID, or author recid — resolve a name with cern_inspire_search_authors first) or query (any INSPIRE literature query: a topic, collaboration, institution, or "a <BAI>"). Document type and subject filters narrow every figure. year_from and year_to narrow the summary to papers from those years, and exclude_self_citations recounts it without self-citations; any of them leaves out citations per year, which INSPIRE cannot narrow that way.
| Argument | Type | Description |
|---|---|---|
| query | string | An INSPIRE literature query, e.g. "collaboration:atlas", "t neutrino oscillation", "a Edward.Witten.1", or "affid:902725" for an institution's papers (CERN; affid takes the institution recid that cern_inspire_search_authors and cern_inspire_search_experiments return). Empty recognized field clauses such as "a:" are invalid; other syntax is passed through without complete grammar validation. Literature queries do not match ORCIDs; pass an ORCID as author. Pass this or author, not both. |
| author | string | One author identifier: INSPIRE BAI (Edward.Witten.1, exact and case-sensitive), ORCID (0000-0002-7752-6073 or an orcid.org URL), INSPIRE ID (INSPIRE-00136372), or author recid. Not a name — resolve names with cern_inspire_search_authors first. Pass this or query, not both. |
| year_to | integer | Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound. |
Fetch one paper's full INSPIRE-HEP record by recid, arXiv ID, or DOI: authors with affiliations 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.
| Argument | Type | Description |
|---|---|---|
| paper* | string | 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 | integer | Most authors to list (nonnegative integer, default 25; values above 500 use 500). Zero lists no authors. The full count is always in authorCount. |
| author_offset | integer | Zero-based starting position in the normalized author list (default 0). Use nextAuthorOffset from the previous page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"paper"
],
"properties": {
"paper": {
"type": "string",
"maxLength": 256,
"description": "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": {
"type": "integer",
"default": 25,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Most authors to list (nonnegative integer, default 25; values above 500 use 500). Zero lists no authors. The full count is always in authorCount."
},
"author_offset": {
"type": "integer",
"default": 0,
"maximum": 9007199254740991,
"minimum": 0,
"description": "Zero-based starting position in the normalized author list (default 0). Use nextAuthorOffset from the previous page."
}
},
"additionalProperties": false
}Decode the vocabulary the other cern_inspire tools take: INSPIRE search syntax (field operators, boolean logic, sort orders, the 10,000-result window, and how malformed queries behave), identifier forms (recid, arXiv, DOI, BAI, ORCID, INSPIRE ID, institution recid, texkey, HEPData DOIs), the document_types and subjects filter values, citation-summary buckets, and HEPData record versions and DOIs. Static content with no upstream call; use it to build a query or to recover from an empty or unexpectedly broad result.
| Argument | Type | Description |
|---|---|---|
| topic* | string | Which vocabulary to decode: search_syntax (query operators and rules), identifiers (paper, author, experiment, institution, and HEPData identifier forms), document_types, subjects, citation_buckets (citation-summary ranges and terms), or hepdata (record versions, DOIs, and licence). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"search_syntax",
"identifiers",
"document_types",
"subjects",
"citation_buckets",
"hepdata"
],
"type": "string",
"description": "Which vocabulary to decode: search_syntax (query operators and rules), identifiers (paper, author, experiment, institution, and HEPData identifier forms), document_types, subjects, citation_buckets (citation-summary ranges and terms), or hepdata (record versions, DOIs, and licence)."
}
},
"additionalProperties": false
}Find physicist profiles in INSPIRE-HEP by name, INSPIRE BAI, ORCID, INSPIRE ID, or author recid. Each profile carries its recid, BAI, ORCID, current and past positions, advisors, arXiv categories, links, awards, and a literatureQuery that selects the person's papers in cern_inspire_search_literature. A name returns ranked candidates (a bare surname can match tens of thousands of profiles, and a less-cited namesake can rank first), so confirm the person from positions and categories before passing a bai or recid to cern_inspire_get_citation_summary. An identifier matches exactly.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Profiles to return (1–25, default 5). |
| query* | string | A physicist's name ("Witten, Edward" or "Edward Witten") or one identifier: INSPIRE BAI (Edward.Witten.1, exact and case-sensitive), ORCID (0000-0002-7752-6073 or an orcid.org URL), INSPIRE ID (INSPIRE-00136372), or author recid. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 25,
"minimum": 1,
"description": "Profiles to return (1–25, default 5)."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "A physicist's name (\"Witten, Edward\" or \"Edward Witten\") or one identifier: INSPIRE BAI (Edward.Witten.1, exact and case-sensitive), ORCID (0000-0002-7752-6073 or an orcid.org URL), INSPIRE ID (INSPIRE-00136372), or author recid."
}
},
"additionalProperties": false
}Find experiments, collaborations, and facilities in INSPIRE-HEP (ATLAS, CMS, DUNE, Belle II, …) by name, accelerator, or INSPIRE legacy name (CERN-LHC-CMS); digits alone look up an experiment recid. Each record carries the accelerator, host institutions, collaboration and subgroups, classification, lifecycle dates (proposed, approved, started, completed, ongoing), INSPIRE's paper count, a description, and a literatureQuery to pass to cern_inspire_search_literature or cern_inspire_get_citation_summary for the experiment's papers.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Experiments to return (1–25, default 5). |
| query* | string | Experiment, collaboration, accelerator, or facility name (ATLAS, LHCb, Tevatron), an INSPIRE legacy name (CERN-LHC-CMS), or an experiment recid (digits only). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 25,
"minimum": 1,
"description": "Experiments to return (1–25, default 5)."
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Experiment, collaboration, accelerator, or facility name (ATLAS, LHCb, Tevatron), an INSPIRE legacy name (CERN-LHC-CMS), or an experiment recid (digits only)."
}
},
"additionalProperties": false
}Find HEPData measurement records by physics content — process, observable, energy, collaboration — when the paper is unknown, through INSPIRE-HEP's index of every HEPData submission. Each hit carries the paper recids (pass to cern_inspire_get_paper), collaborations, keywords (reactions such as "P P --> TOP TOPBAR X", observables, centre-of-mass energies), the HEPData record DOI (recordDoi, the citation for the data), latest version, table count, and hepdataUrl, the hepdata.net record page that holds the table values; this tool does not return the values themselves. Only the first 10,000 results of a query are reachable.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. page × size may not exceed 10,000. |
| size | integer | Records per page (1–50, default 10). |
| sort | string | Result order: relevance (default) or mostrecent. |
| query* | string | Free text or INSPIRE syntax over HEPData records, e.g. top pair differential cross section 13 TeV; collaborations.value:LHCb; keywords.value:"Inclusive"; or literature.control_number:<recid> for one paper's data. INSPIRE does not reject malformed syntax; see cern_inspire_list_reference topic search_syntax. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. page × size may not exceed 10,000."
},
"size": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Records per page (1–50, default 10)."
},
"sort": {
"enum": [
"relevance",
"mostrecent"
],
"type": "string",
"default": "relevance",
"description": "Result order: relevance (default) or mostrecent."
},
"query": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Free text or INSPIRE syntax over HEPData records, e.g. top pair differential cross section 13 TeV; collaborations.value:LHCb; keywords.value:\"Inclusive\"; or literature.control_number:<recid> for one paper's data. INSPIRE does not reject malformed syntax; see cern_inspire_list_reference topic search_syntax."
}
},
"additionalProperties": false
}Search INSPIRE-HEP papers with INSPIRE query syntax or free text, filtered by document type, subject, and year, sorted by relevance, recency, or citations. Returns one page of papers with recid, title, first author, date, citation counts, arXiv ID, DOI, publication, and an abstract snippet; pass a recid to cern_inspire_get_paper for the full record or to cern_inspire_export_citations ("recid:N") for BibTeX. Empty recognized field clauses are invalid; other malformed syntax can widen or empty the match, so check an unexpectedly broad or empty result against cern_inspire_list_reference topic search_syntax. Only the first 10,000 results of a query are reachable.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. page × size may not exceed 10,000. |
| size | integer | Papers per page (1–100, default 10). |
| sort | string | Result order: relevance (default), mostrecent, or mostcited. |
| query* | string | INSPIRE query syntax or free text. Common operators: "a Jane.Doe.1" or "a Doe, J" (author), "t higgs boson" (title words), "cn atlas" or "collaboration:atlas" (collaboration), "date > 2015", "topcite 500+" (cited 500+ times), "refersto:recid:451647" (papers citing a record), "citedby:recid:451647" (its references), "j Phys.Rev.Lett." (journal), "eprint 1207.7214"; combine with and/or/not. Bare words search all fields. Empty recognized field clauses such as "a:" are invalid; other syntax is passed to INSPIRE without complete grammar validation. See cern_inspire_list_reference topic search_syntax. |
| subjects | array | 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 | integer | Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound. |
| document_types | array | 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. |
| exclude_self_citations | boolean | Count citations without self-citations (INSPIRE's definition), default false. Setting it leaves out citationsByYear, which always includes self-citations. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"maxLength": 1000,
"description": "An INSPIRE literature query, e.g. \"collaboration:atlas\", \"t neutrino oscillation\", \"a Edward.Witten.1\", or \"affid:902725\" for an institution's papers (CERN; affid takes the institution recid that cern_inspire_search_authors and cern_inspire_search_experiments return). Empty recognized field clauses such as \"a:\" are invalid; other syntax is passed through without complete grammar validation. Literature queries do not match ORCIDs; pass an ORCID as author. Pass this or author, not both."
},
"author": {
"type": "string",
"maxLength": 200,
"description": "One author identifier: INSPIRE BAI (Edward.Witten.1, exact and case-sensitive), ORCID (0000-0002-7752-6073 or an orcid.org URL), INSPIRE ID (INSPIRE-00136372), or author recid. Not a name — resolve names with cern_inspire_search_authors first. Pass this or query, not both."
},
"year_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound."
},
"subjects": {
"type": "array",
"items": {
"enum": [
"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"
],
"type": "string",
"description": "An INSPIRE subject category."
},
"maxItems": 4,
"description": "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": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound."
},
"document_types": {
"type": "array",
"items": {
"enum": [
"article",
"published",
"conference paper",
"thesis",
"review",
"note",
"proceedings",
"lectures",
"book chapter",
"book",
"introductory",
"activity report",
"report"
],
"type": "string",
"description": "An INSPIRE document type."
},
"maxItems": 4,
"description": "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."
},
"exclude_self_citations": {
"type": "boolean",
"default": false,
"description": "Count citations without self-citations (INSPIRE's definition), default false. Setting it leaves out citationsByYear, which always includes self-citations."
}
},
"additionalProperties": false
}| year_to | integer | Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound. |
| subjects | array | 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 | integer | Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound. |
| document_types | array | 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. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1. page × size may not exceed 10,000."
},
"size": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Papers per page (1–100, default 10)."
},
"sort": {
"enum": [
"relevance",
"mostrecent",
"mostcited"
],
"type": "string",
"default": "relevance",
"description": "Result order: relevance (default), mostrecent, or mostcited."
},
"query": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "INSPIRE query syntax or free text. Common operators: \"a Jane.Doe.1\" or \"a Doe, J\" (author), \"t higgs boson\" (title words), \"cn atlas\" or \"collaboration:atlas\" (collaboration), \"date > 2015\", \"topcite 500+\" (cited 500+ times), \"refersto:recid:451647\" (papers citing a record), \"citedby:recid:451647\" (its references), \"j Phys.Rev.Lett.\" (journal), \"eprint 1207.7214\"; combine with and/or/not. Bare words search all fields. Empty recognized field clauses such as \"a:\" are invalid; other syntax is passed to INSPIRE without complete grammar validation. See cern_inspire_list_reference topic search_syntax."
},
"year_to": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Latest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no upper bound."
},
"subjects": {
"type": "array",
"items": {
"enum": [
"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"
],
"type": "string",
"description": "An INSPIRE subject category."
},
"maxItems": 4,
"description": "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": {
"type": "integer",
"maximum": 2100,
"minimum": 1900,
"description": "Earliest year to include (1900–2100, inclusive), matched on the earliest date INSPIRE records for the paper. Omit for no lower bound."
},
"document_types": {
"type": "array",
"items": {
"enum": [
"article",
"published",
"conference paper",
"thesis",
"review",
"note",
"proceedings",
"lectures",
"book chapter",
"book",
"introductory",
"activity report",
"report"
],
"type": "string",
"description": "An INSPIRE document type."
},
"maxItems": 4,
"description": "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."
}
},
"additionalProperties": false
}