Raw schema
{
"type": "object",
"properties": {
"cids": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"description": "PubChem Compound IDs to fetch (1-100). Resolve from names/SMILES with pubchem_search_compounds."
},
"properties": {
"description": "Properties to retrieve. Defaults to a core set: MolecularFormula, MolecularWeight, IUPACName, CanonicalSMILES, IsomericSMILES, InChIKey, XLogP, TPSA, HBondDonorCount, HBondAcceptorCount, RotatableBondCount, HeavyAtomCount, Charge, Complexity.",
"type": "array",
"items": {
"type": "string",
"enum": [
"MolecularFormula",
"MolecularWeight",
"CanonicalSMILES",
"IsomericSMILES",
"InChI",
"InChIKey",
"IUPACName",
"Title",
"XLogP",
"ExactMass",
"MonoisotopicMass",
"TPSA",
"Complexity",
"Charge",
"HBondDonorCount",
"HBondAcceptorCount",
"RotatableBondCount",
"HeavyAtomCount",
"IsotopeAtomCount",
"AtomStereoCount",
"DefinedAtomStereoCount",
"UndefinedAtomStereoCount",
"BondStereoCount",
"DefinedBondStereoCount",
"UndefinedBondStereoCount",
"CovalentUnitCount",
"Volume3D"
]
}
},
"includeDescription": {
"default": false,
"description": "Include textual descriptions (pharmacology, mechanism, therapeutic use) attributed by source. Well-studied compounds have many overlapping summaries โ paged via descriptionOffset/maxDescriptions. Fetched only for the first 10 CIDs in the batch; remaining CIDs return without descriptions and are listed in the response's skippedCids.",
"type": "boolean"
},
"descriptionOffset": {
"default": 0,
"description": "Zero-based index of the first description to return within each compound's description list. The same offset is applied to every compound in the batch. Pass the nextDescriptionOffset from a previous call to read the following page. Default: 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxDescriptions": {
"default": 3,
"description": "Max number of distinct description entries per compound per page (1-20). PubChem returns near-duplicate summaries from many depositors; duplicates are collapsed before this cap applies. Default: 3.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"includeSynonyms": {
"default": false,
"description": "Fetch known names and synonyms (trade names, systematic names, registry numbers), paged via synonymOffset/maxSynonyms. Fetched for every found CID in the batch. Slower for large CID lists.",
"type": "boolean"
},
"synonymOffset": {
"default": 0,
"description": "Zero-based index of the first synonym to return within each compound's synonym list. The same offset is applied to every compound in the batch. Pass the nextSynonymOffset from a previous call to read the following page. Default: 0.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"maxSynonyms": {
"default": 20,
"description": "Max synonyms returned per compound per page (1-100). PubChem lists hundreds for common drugs; use synonymOffset to reach the ones past this page. Default: 20.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"includeDrugLikeness": {
"default": false,
"description": "Compute drug-likeness assessment: Lipinski Rule of Five (MW, XLogP, HBD, HBA) and Veber rules (TPSA, rotatable bonds). Computed from the returned properties, so it adds no latency.",
"type": "boolean"
},
"includeClassification": {
"default": false,
"description": "Include pharmacological classification: FDA Established Pharmacologic Classes, mechanisms of action, MeSH classes, and ATC codes. Fetched only for the first 10 CIDs in the batch; remaining CIDs return without classification and are listed in the response's skippedCids.",
"type": "boolean"
}
},
"required": [
"cids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}