JSON API
Read-only JSON for the compounds, reactions and physical data behind the site. No key, no sign-up. Please keep it to a few requests per second.
/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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.