{"openapi":"3.1.0","info":{"title":"Crystallography API","version":"1.0.0","description":"Crystal structures as an API — powered by the Crystallography Open Database (COD), the open, public-domain collection of over 500,000 crystal structures of organic, inorganic, metal-organic compounds and minerals. Search the database by chemical formula (any standard casing — TiO2, Al2O3, H2O — is normalised automatically) or by free text over mineral names, titles and comments, then look up any structure to get its full crystallographic data: chemical and cell formula, space group (Hermann-Mauguin and Hall), the complete unit cell (a, b, c, alpha, beta, gamma and volume), the source publication (title, authors, journal, year, DOI) and a link to the CIF file. From quartz, calcite and diamond to anatase, corundum and diopside, it is ideal for materials science, solid-state chemistry, mineralogy, crystallography teaching and research tooling. This is a crystal-structure & materials database — distinct from molecule-property (chemistry / PubChem) and protein-structure (PDB) databases. Open data from the Crystallography Open Database (CC0 / public domain).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cod-api","description":"oanor gateway"}],"tags":[{"name":"Crystallography"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Crystallography"],"summary":"Search crystal structures by formula or text","description":"","parameters":[{"name":"formula","in":"query","required":false,"description":"Chemical formula, any casing (TiO2, Al2O3, H2O)","schema":{"type":"string"},"example":"TiO2"},{"name":"text","in":"query","required":false,"description":"Free-text search over minerals, titles and comments","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mode":"formula","count":25,"query":"O2 Ti","total":39,"structures":[{"url":"https://www.crystallography.net/cod/1010942.html","year":1924,"title":"Zur Kristallstruktur von Anastas und Rutil. (II. Teil. Die Anastasstruktur).","cod_id":"1010942","formula":"O2 Ti","mineral":"Anatase","space_group":"I 41/a m d :1"},{"url":"https://www.crystallography.net/cod/1526931.html","year":2000,"title":"Rietveld analysis of electron powder diffraction data from nanocrystalline anatase, Ti O2","cod_id":"1526931","formula":"O2 Ti","space_group":"I 41/a m d :2"},{"url":"https://www.crystallography.net/cod/1528778.html","year":2006,"title":"Structure of beta - Ti O2","cod_id":"1528778","formula":"O2 Ti","space_group":"C 1 2/m 1"},{"url":"https://www.crystallography.net/cod/1530026.html","year":1988,"title":"Ti O2-II. Ambient pressure and structure refinement","cod_id":"1530026","formula":"O2 Ti","space_group":"P b c n"},{"url":"https://www.crystallography.net/cod/1530150.html","year":1977,"title":"An electron-diffraction investigation of titanium dioxide in thin films","cod_id":"1530150","formula":"O2 Ti","space_group":"P 42/m n m"},{"url":"https://www.crystallography.net/cod/1530151.html","year":1977,"title":"An electron-diffraction investigation of titanium dioxide in thin films","cod_id":"1530151","formula":"O2 Ti","space_group":"I 41/a m d :1"},{"url":"https://www.crystallography.net/cod/1532819.html","year":2003,"title":"Intergrown niobian rutile phases with Sc- and W-rich ferrocolumbite: an electron-microprobe and Rietveld study","cod_id":"1532819","formula":"O2 Ti","space_group":"P 42/m n m"},{"url":"https://www.crystallography.net/cod/1534781.html","year":1984,"title":"High Temperature Structures of the Rutile-Type Oxides, TiO~2~ and SnO~2~","cod_id":"1534781","formula":"O2 Ti","space_group":"P 42/m n m"},{"url":"https://www.crystallography.net/cod/1537224.html","year":1993,"title":"Crystal-structure calculations with distorted ions","cod_id":"1537224","formula":"O2 Ti","space_group":"P 31 2 1"},{"url":"https://www.crystallography.net/cod/1539682.html","year":1992,"title":"The soft chemical synthesis of Ti O2 (B) from layered titanates","cod_id":"1539682","formula":"O2 Ti","space_group":"P 1 21/m 1"},{"url":"https://www.crystallography.net/cod/1544349.html","year":1994,"title":"Topotactic oxidation of ramsdellite-type Li0.5TiO2, a new polymorph of titanium dioxide: TiO2(R)","cod_id":"1544349","formula":"O2 Ti","space_group":"P b n m"},{"url":"https://www.crystallography.net/cod/1557789.html","year":2020,"title":"Riesite, a New High Pressure Polymorph of TiO2 from the Ries Impact Structure","cod_id":"1557789","formula":"O2 Ti","space_group":"P 1 2/c 1"},{"url":"https://www.crystallography.net/cod/1562532.html","year":2013,"title":"Transformation of rutile to TiO2-II in a high pressure hydrothermal environment","cod_id":"1562532","formula":"O2 Ti","space_group":"P b c n"},{"url":"https://www.crystallography.net/cod/2310486.html","year":1967,"title":"The structure of Ti O2 II, a high-pressure phase of Ti O2","cod_id":"2310486","formula":"O2 Ti","space_group":"P b c n"},{"url":"https://www.crystallography.net/cod/2310710.html","year":2002,"title":"Structure of nanocrystalline anatase solved and refined from electron powder data","cod_id":"2310710","formula":"O2 Ti","space_group":"I 41/a m d :2"},{"url":"https://www.crystallography.net/cod/4102355.html","year":2010,"title":"Half-Metallic Ferromagnetism and Large Negative Magnetoresistance in the New Lacunar Spinel GaTi3VS8","cod_id":"4102355","formula":"O2 Ti","space_group":"P 42/m n m"},{"url":"https://www.crystallography.net/cod/4124498.html","year":2003,"title":"Surface structures of Sr Ti O3 (001): A (Ti O2)-rich reconstruction with a c(4 X 2) unit cell","cod_id":"4124498","formula":"O2 Ti","space_group":"P 1"},{"url":"https://www.crystallography.net/cod/5000223.html","year":1972,"title":"Refinement of the structure of anatase at several temperatures Sample: T = 300 C","cod_id":"5000223","formula":"O2 Ti","mineral":"Anatase","space_group":"I 41/a m d :1"},{"url":"https://www.crystallography.net/cod/7206075.html","year":2011,"title":"The role of brookite in mechanical activation of anatase-to-rutile transformation of nanocrystalline TiO2: An XRD and Raman spectroscopy investigation","cod_id":"7206075","formula":"O2 Ti","mineral":"Anatase","space_group":"I 41/a m d :1"},{"url":"https://www.crystallography.net/cod/8104269.html","year":1928,"title":"The crystal structure of brookite","cod_id":"8104269","formula":"O2 Ti","space_group":"P b c a"},{"url":"https://www.crystallography.net/cod/9004137.html","year":1979,"title":"Polyhedral thermal expansion in the TiO2 polymorphs: Refinement of the crystal structures of rutile and brookite at high temperature Sample at 25 degrees C","cod_id":"9004137","formula":"O2 Ti","mineral":"Brookite","space_group":"P b c a"},{"url":"https://www.crystallography.net/cod/9004138.html","year":1979,"title":"Polyhedral thermal expansion in the TiO2 polymorphs: Refinement of the crystal structures of rutile and brookite at high temperature Sample at 280 degrees C","cod_id":"9004138","formula":"O2 Ti","mineral":"Brookite","space_group":"P b c a"},{"url":"https://www.crystallography.net/cod/9004139.html","year":1979,"title":"Polyhedral thermal expansion in the TiO2 polymorphs: Refinement of the crystal structures of rutile and brookite at high temperature Sample at 425 degrees C","cod_id":"9004139","formula":"O2 Ti","mineral":"Brookite","space_group":"P b c a"},{"url":"https://www.crystallography.net/cod/9004140.html","year":1979,"title":"Polyhedral thermal expansion in the TiO2 polymorphs: Refinement of the crystal structures of rutile and brookite at high temperatures Sample at 625 degrees C","cod_id":"9004140","formula":"O2 Ti","mineral":"Brookite","space_group":"P b c a"},{"url":"https://www.crystallography.net/cod/9004141.html","year":1979,"title":"Polyhedral thermal expansion in the TiO2 polymorphs: Refinement of the crystal structure of rutile and brookite at high temperature Sample at 25 degrees C","cod_id":"9004141","formula":"O2 Ti","mineral":"Rutile","space_group":"P 42/m n m"}]},"meta":{"timestamp":"2026-06-01T16:23:14.858Z","request_id":"77ceca50-778a-4569-bbd7-c37b1888b0fa"},"status":"ok","message":"Structures retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/structure":{"get":{"operationId":"get_v1_structure","tags":["Crystallography"],"summary":"A crystal structure: cell, space group, citation","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"A COD id (from /v1/search)","schema":{"type":"string"},"example":"2100348"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"structure":{"doi":"10.1107/S010876810503747X","url":"https://www.crystallography.net/cod/2100348.html","cell":{"a":7.287,"b":9.2,"c":6.688,"beta":90,"alpha":90,"gamma":90,"volume":448.4},"year":2006,"title":"Pressure-frozen benzene I revisited","cod_id":"2100348","authors":"Budzianowski, Armand; Katrusiak, Andrzej","cif_url":"https://www.crystallography.net/cod/2100348.cif","formula":"C6 H6","journal":"Acta Crystallographica Section B","space_group":"P b c a","cell_formula":"C24 H24","space_group_hall":"-P 2ac 2ab"}},"meta":{"timestamp":"2026-06-01T16:23:15.049Z","request_id":"dee10794-9954-4650-9f50-7968f026293c"},"status":"ok","message":"Structure retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"COD (the Crystallography Open Database) is the open, public-domain collection of crystal structures of organic, inorganic, metal-organic compounds and minerals — over 500,000 entries, each with unit-cell parameters, a space group, a chemical formula and the publication it came from. /v1/search?formula=TiO2 = find structures by chemical formula (any standard casing — TiO2, Al2O3, H2O — is normalised to COD's alphabetical form), or /v1/search?text=quartz = free-text search over mineral names, titles and comments; both return each match's COD id (e.g. 2100348), formula, mineral, space group and year. /v1/structure?id=2100348 = a single structure's crystallographic data — chemical and cell formula, space group (Hermann-Mauguin and Hall), full unit cell (a, b, c, alpha, beta, gamma and volume), the source publication (title, authors, journal, year, DOI) and links to the CIF file. Get a COD id from /v1/search. Data from the Crystallography Open Database (CC0 / public domain). A crystal-structure & materials database — distinct from molecule-property (chemistry/PubChem), protein-structure (PDB) and sequence databases. Ideal for materials science, solid-state chemistry, mineralogy and education.","source":"Crystallography Open Database (crystallography.net)","endpoints":["/v1/search","/v1/structure","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:15.134Z","request_id":"ef1b34c7-7697-4138-8256-330e0d5240f8"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2200,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":690,"monthly_call_quota":52000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2150,"monthly_call_quota":240000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5850,"monthly_call_quota":880000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cod-api"}