/api/molecules/<cas>

One compound: names, formula, identifiers (SMILES, InChI, InChIKey), molar and exact mass, density, melting and boiling point, Antoine constants, azeotropes, reactions it takes part in, and a structure image URL.

Example
curl -s 'https://chempirical.com/api/molecules/64-17-5' | jq -c '.name, .properties.molar_mass_g_per_mol, .physical.boilingPoint.text'

"Ethanol"
46.069
"78.5 °C"

/api/molecules?q=

Search compounds by name, CAS number, formula or SMILES. Parameters: q, limit (at most 200), offset. total counts the matches up to offset + limit.

Example
curl -s 'https://chempirical.com/api/molecules?q=caffeine&limit=2' | jq -c '.results[] | {cas, name, molarMass}'

{"cas":"58-08-2","name":"Caffeine","molarMass":194.194}
{"cas":"5743-12-4","name":"Caffeine monohydrate","molarMass":212.209}

/api/molecules?substructure=

Every compound containing a fragment, given as SMILES or SMARTS, matched by structure over the whole catalogue. Parameters: substructure, limit (at most 200), offset. Results come in name order; total counts the matches up to offset + limit and capped says whether more exist.

Example
curl -s 'https://chempirical.com/api/molecules?substructure=c1ccc2%5BnH%5Dccc2c1&limit=2' | jq -c '{total, capped, first: .results[0].name}'

{"total":2,"capped":true,"first":"(-)-Mitragynine"}

/api/molecules?similar=

Compounds most similar to a structure, given as SMILES: Tanimoto similarity of circular fingerprints, most similar first, each result carrying its similarity from 0 to 1. Parameters: similar, limit (at most 200), offset.

Example
curl -s 'https://chempirical.com/api/molecules?similar=CC(%3DO)Oc1ccccc1C(%3DO)O&limit=3' | jq -c '.results[] | {name, similarity}'

{"name":"Aspirin","similarity":1}
{"name":"Acetylsalicylsalicylic acid","similarity":0.853}
{"name":"3-Acetoxy-O-toluic acid","similarity":0.722}

/api/molecules/identify?smiles=

One compound by its structure, given as SMILES, matched on the canonical structure so any spelling of the same molecule finds it. sameStereo says whether the match is the same stereoisomer or only the same constitution, and match is null when the catalogue has none. structureKey is the compound's identity from the structure alone: two spellings of one molecule share it, enantiomers and salts do not, and a structure the catalogue has never seen still gets one.

Example
curl -s 'https://chempirical.com/api/molecules/identify?smiles=CCO' | jq -c '{name: .match.name, sameStereo, structureKey}'

{"name":"Ethanol","sameStereo":true,"structureKey":"ab1de819ede91df490e6441934decfa9041b49f91d6bbadbba4df634ccff57fa"}

/api/molecules/resolve

POST a list of names, CAS numbers or SMILES (at most 200) as {"terms": [...]} and get each one matched to a catalogue compound by its exact CAS number, name, synonym, formula or structure, with formula, molar mass, density, melting and boiling point, flash point, pKa and GHS hazards (signal word, pictograms, H statements with their text, P codes and whether the classification is EU harmonised, with its Annex VI index, or notified), or null when nothing matches. Same-origin only.

Example
curl -s -X POST https://chempirical.com/api/molecules/resolve -H 'content-type: application/json' -H 'origin: https://chempirical.com' -d '{"terms":["ethanol","50-78-2"]}' | jq -c '.results[] | {term, name: .compound.name}'

{"term":"ethanol","name":"Ethanol"}
{"term":"50-78-2","name":"Aspirin"}

/api/molecules/suggest?q=

Typeahead for compound pickers: the best eight matches with molar mass, density and boiling point.

Example
curl -s 'https://chempirical.com/api/molecules/suggest?q=thf' | jq -c '.results[0] | {name, density: .density.text, boilingPoint: .boilingPoint.text}'

{"name":"Tetrahydrofuran","density":"0.89 g/mL","boilingPoint":"65 °C"}

/api/molecule-svg/<cas>

The structure as SVG. Add ?theme=dark for light lines on a dark background.

Example
curl -s 'https://chempirical.com/api/molecule-svg/50-78-2' > aspirin.svg

/api/reactions

Reactions with filters: q (name and summary), reaction_type, source, calc_ready=1 for the ones with equivalents on file, limit, offset.

Example
curl -s 'https://chempirical.com/api/reactions?calc_ready=1&limit=3' | jq -c '.results[].slug'

"cannizzaro-disproportionation"
"aldol-benzalacetone"
"diels-alder-norbornene"

/api/reactions/<slug>

One reaction with its participants: role, equivalents, molar mass and density of each.

Example
curl -s 'https://chempirical.com/api/reactions/henry-nitroaldol' | jq -c '.participants[] | {name, role, equivalents}'

{"name":"Benzaldehyde","role":"reactant","equivalents":1}
{"name":"Nitromethane","role":"reactant","equivalents":1}
{"name":"n-Butylamine","role":"catalyst","equivalents":0.1}
{"name":"Acetic acid","role":"solvent","equivalents":null}
{"name":"β-Nitrostyrene","role":"product","equivalents":1}

/api/reactions/<slug>/scale

Scale a reaction from one reagent: anchor_cas, anchor_unit (g, mL, mmol or mol) and anchor_value.

Example
curl -s 'https://chempirical.com/api/reactions/henry-nitroaldol/scale?anchor_cas=100-52-7&anchor_unit=g&anchor_value=10.6' | jq -c '.participants[] | {name, mass_g}'

{"name":"Benzaldehyde","mass_g":10.6}
{"name":"Nitromethane","mass_g":6.096867815008858}
{"name":"n-Butylamine","mass_g":0.7305354114055257}
{"name":"Acetic acid","mass_g":103.87848177603558}
{"name":"β-Nitrostyrene","mass_g":14.897472767705704}

/api/components?cas=

Pure-component records for process simulation, for up to 40 CAS numbers: critical constants, acentric factor, normal boiling point, ideal-gas enthalpy and Gibbs energy of formation, UNIFAC and modified UNIFAC (Dortmund) groups and temperature correlations, all in SI units per mole (correlations per kmol, as the ChemSep databank stores them). source names the origin of every value: chempirical-fit-2026 (our own regression to the measurements of the NIST ThermoML archive, first wherever it reproduces them better than ChemSep; fit gives its points, temperature range, mean and worst relative deviation, ChemSep's deviation on the same points and the data set DOIs, and chemsep keeps ChemSep's own value), chemsep or a catalogue source for measured data, chempirical-gc-2026 (group contributions fitted here to the ChemSep bank and the catalogue's boiling points), joback, ambrose-walton, yamada-gunn, rackett or watson for an estimate from the structure, structure for what follows from the formula. uncertainty gives the 95 % bound of a group-contribution estimate in the unit of its field, measured on held-out structure classes; an estimated heat capacity correlation carries it as a fraction. A polymer (LDPE 9002-88-4, poly(vinyl acetate) 9003-20-7, EVA 24937-78-8) comes as a pseudo-component without critical constants: molarMass is its number-average molar mass, polymer gives the weight fraction of each monomer unit with Mn and Mw, pcSaft the PC-SAFT segment parameters per unit (Gross and Sadowski 2002, Tumakaka et al. 2002), and its enthalpy and Gibbs energy of formation and ideal-gas heat capacity are Joback's groups of the repeat units. unavailable lists what cannot be estimated. binaries holds the interaction parameters of every requested pair, per model (nrtl, wilson, peng-robinson, srk, henry for a gas in water) our own regression to the NIST ThermoML archive first (source thermoml, with the data sets, their DOIs and the mean deviation in bubble pressure and vapour mole fraction under fit), then a published set (source names the article); a thermodynamics core takes the first record of a pair and model.

Example
curl -s 'https://chempirical.com/api/components?cas=64-19-7,50-78-2' | jq -c '.components[] | {name, criticalTemperature, acentricFactor, from: .source.criticalTemperature}'

{"name":"Acetic acid","criticalTemperature":594.45,"acentricFactor":0.46,"from":"chemsep"}
{"name":"Aspirin","criticalTemperature":778.08,"acentricFactor":0.7525,"from":"chempirical-gc-2026"}

/api/antoine

Every set of Antoine constants in the database, log10(P/mmHg) = A − B/(C + T/°C), with its valid temperature range.

Example
curl -s 'https://chempirical.com/api/antoine' | jq -c '.results[0]'

{"cas":"107-06-2","name":"1,2-Dichloroethane","smiles":"ClCCCl","a":7.0253,"b":1271.3,"c":222.93,"minimumTemperature":6,"maximumTemperature":100}

/api/azeotropes

Binary azeotropes with composition, boiling temperature and type.

Example
curl -s 'https://chempirical.com/api/azeotropes' | jq -c '.results[0]'

{"components":[{"cas":"64-17-5","name":"Ethanol"},{"cas":"7732-18-5","name":"Water"}],"type":"min","temperatureC":78.2,"pressureMmHg":760,"dominant":"64-17-5","dominantMassPercent":95.6,"pressureBreak":"no","heterogeneous":false,"note":"Ethanol/water — limits straight-distillation purity to ~95.6 wt%."}

Conventions

Responses are UTF-8 JSON with CORS open to every origin. Units are SI or the units chemists read: g/mol, g/mL, °C, mmHg. New fields may appear at any time, so ignore the ones you do not know. A missing compound or reaction answers 404 with an error message.