Search the CERN Open Data Portal's datasets, software, environments, documentation and supplementary records with exact-vocabulary filters and an optional full-text query. The filters are experiment, record type, physics category, keyword, collision energy and type, file format, data-taking year, event count, availability, collection, and LHCb magnet polarity, stripping stream and stripping version. Returns compact hits with recids plus live facet counts. Each facet ignores its own filter, so its counts show the alternatives under the other filters. Filter values are exact upstream; common spellings are normalized, and cern_opendata_list_reference lists the vocabulary. Paging reaches the first 10,000 matches.
View input schema
{
"type": "object",
"properties": {
"query": {
"description": "Verbatim OpenSearch query_string: AND between terms, double weight for title matches. Supports title:\"…\", recid:(1 OR 2), run_period:(\"Run2012B\"); cern_opendata_list_reference topic query_syntax lists forms. Omit for filters alone.",
"type": "string",
"maxLength": 500
},
"type": {
"description": "Up to 7 types (OR): Dataset, Documentation, Environment, Software, Supplementaries, News, or Primary::Secondary (Dataset::Collision, Dataset::Simulated). Omit for all six primaries; Glossary is excluded.",
"maxItems": 7,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One type value."
}
},
"experiment": {
"description": "Up to 9 experiments (OR): ALICE, ATLAS, CMS, DELPHI, JADE, LHCb, OPERA, PHENIX, TOTEM. Case normalized.",
"maxItems": 9,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One experiment value."
}
},
"collision_energy": {
"description": "Up to 15 energies (OR), e.g. 7TeV, 8TeV, 13TeV, 5.02TeV. \"13TeV, 13.6TeV\" is one value/item.",
"maxItems": 15,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One collision_energy value."
}
},
"collision_type": {
"description": "Up to 6 collision types (OR): pp, PbPb, pPb, e+e-, Interfill. PbPb also matches Pb-Pb.",
"maxItems": 6,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One collision_type value."
}
},
"file_type": {
"description": "Up to 20 formats/data tiers (OR): nanoaod, miniaod, aod, root, DAOD_PHYSLITE, csv, etc. Known-value case normalized.",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One file_type value."
}
},
"year_from": {
"description": "Inclusive earliest data-taking year; alone means onward. For one year, set both year bounds to it.",
"type": "integer",
"minimum": 1900,
"maximum": 2100
},
"year_to": {
"description": "Inclusive latest data-taking year; alone means through this year.",
"type": "integer",
"minimum": 1900,
"maximum": 2100
},
"min_events": {
"description": "Minimum number of events, inclusive.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"max_events": {
"description": "Maximum number of events, inclusive.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"availability": {
"description": "Up to 4 availability states (OR): online, partial, ondemand (tape; request before download), requested.",
"maxItems": 4,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One availability value."
}
},
"collection": {
"description": "Up to 10 exact, case-sensitive collections (OR), e.g. CMS-Validated-Runs; copy a record's collections spellings.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One collection name, exact and case-sensitive."
}
},
"category": {
"description": "Up to 20 simulated-dataset categories (OR): primary (Exotica, Higgs Physics, Standard Model Physics, Supersymmetry) or Primary::Secondary (Higgs Physics::Standard Model). Case/separator normalized. Commas stay within an item (Exotica::Heavy Fermions, Heavy Righ-Handed Neutrinos). Heavy-Ion Physics also matches its leading-space spelling. cern_opendata_list_reference topic categories lists all values.",
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One category value."
}
},
"keywords": {
"description": "Up to 10 verbatim, case-sensitive keywords (OR); Education differs from education. A comma within a keyword stays in one item.",
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One keyword, exact and case-sensitive."
}
},
"magnet_polarity": {
"description": "Up to 2 LHCb collision-dataset polarities (OR): MagDown, MagUp. Case normalized.",
"maxItems": 2,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One magnet_polarity value."
}
},
"stripping_stream": {
"description": "Up to 11 LHCb stripping streams (OR), e.g. BHADRON, CHARM, DIMUON, EW, LEPTONIC; also matches stripping docs. Case normalized. cern_opendata_list_reference topic lhcb lists them.",
"maxItems": 11,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One stripping_stream value."
}
},
"stripping_version": {
"description": "Up to 12 LHCb stripping versions (OR), e.g. stripping21, stripping21r1p2. Case normalized.",
"maxItems": 12,
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"description": "One stripping_version value."
}
},
"sort": {
"description": "bestmatch (relevance), mostrecent (by date_published, newest first), title (A-Z) or title_desc (Z-A). Omitted: bestmatch with a query, mostrecent (newest first) without.",
"type": "string",
"enum": [
"bestmatch",
"mostrecent",
"title",
"title_desc"
]
},
"limit": {
"description": "Hits per page, 1-50. A value above 50 is served at 50.",
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"page": {
"description": "Page number, from 1, counting pages of the limit applied. page × limit may not exceed 10,000.",
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}