GET /result
Operation ID: searchStructures
Auth: unknown
Description
Search the COD database using various criteria including text, chemical formula, elements, crystallographic parameters, and publication metadata.
Parameters (49)
(number, query, optional)
Maximum value for lattice angle alpha (in degrees)
(number, query, optional)
Minimum value for lattice angle alpha (in degrees)
(number, query, optional)
Maximum value for lattice parameter a (in Angstroms)
(number, query, optional)
Minimum value for lattice parameter a (in Angstroms)
(number, query, optional)
Maximum value for lattice angle beta (in degrees)
(number, query, optional)
Minimum value for lattice angle beta (in degrees)
(number, query, optional)
Maximum value for lattice parameter b (in Angstroms)
(number, query, optional)
Minimum value for lattice parameter b (in Angstroms)
(number, query, optional)
Maximum value for lattice parameter c (in Angstroms)
(number, query, optional)
Minimum value for lattice parameter c (in Angstroms)
(string, query, optional)
DOI (Digital Object Identifier) of the publication
(string, query, optional)
First element that must be present in the structure
(string, query, optional)
Second element that must be present in the structure
(string, query, optional)
Third element that must be present in the structure
(string, query, optional)
Fourth element that must be present in the structure
(string, query, optional)
Fifth element that must be present in the structure
(string, query, optional)
Sixth element that must be present in the structure
(string, query, optional)
Seventh element that must be present in the structure
(string, query, optional)
Eighth element that must be present in the structure
(string, query, optional, default: html)
Output format for search results
Constraints: {'enum': ['json', 'html', 'csv', 'lst', 'urls', 'zip', 'count']}
(string, query, optional)
Chemical formula in Hill notation (e.g., 'C8 H10 N4 O2' for caffeine)
(number, query, optional)
Maximum value for lattice angle gamma (in degrees)
(number, query, optional)
Minimum value for lattice angle gamma (in degrees)
(integer, query, optional)
Filter for entries with X-ray reflection files (structure factor data)
Constraints: {'enum': [0, 1]}
(string, query, optional)
COD ID(s) to search for. Multiple IDs can be separated by commas or new lines. Use % as wildcard.
(integer, query, optional)
Include duplicate entries in results
Constraints: {'enum': [0, 1]}
(integer, query, optional)
Include entries with errors in results
Constraints: {'enum': [0, 1]}
(integer, query, optional)
Include theoretical/predicted structures in results
Constraints: {'enum': [0, 1]}
(string, query, optional)
Journal issue
(string, query, optional)
Journal name for publication search
(integer, query, optional)
Maximum number of results to return
(integer, query, optional)
Maximum Z value (number of formula units per unit cell)
(number, query, optional)
Maximum Z' value
(integer, query, optional)
Minimum Z value (number of formula units per unit cell)
(number, query, optional)
Minimum Z' value
(string, query, optional)
First element that must NOT be present in the structure
(string, query, optional)
Second element that must NOT be present in the structure
(string, query, optional)
Third element that must NOT be present in the structure
(string, query, optional)
Fourth element that must NOT be present in the structure
(string, query, optional)
Substructure query in SMARTS notation
(integer, query, optional)
Space group number from International Tables for Crystallography Vol. A
(string, query, optional)
Space group symbol in Hermann-Mauguin notation
(integer, query, optional)
Maximum number of distinct elements
(integer, query, optional)
Minimum number of distinct elements
(string, query, optional)
Text search in metadata including bibliographic info, compound names, and mineral names
(number, query, optional)
Maximum unit cell volume (in cubic Angstroms)
(number, query, optional)
Minimum unit cell volume (in cubic Angstroms)
(string, query, optional)
Journal volume
(integer, query, optional)
Publication year
Examples (5)
| Title | Type | URL | Action |
|---|---|---|---|
| Search by chemical formula (SiO2) | curl |
http://www.crystallography.net/result?formula=Si+O2&format=json |
|
| Search by elements (Iron and Oxygen) | curl |
http://www.crystallography.net/result?el1=Fe&el2=O&format=json |
|
| Search by COD ID with wildcard | curl |
http://www.crystallography.net/result?id=10000%&format=json |
|
| Search crystal structures | openapi-spec |
https://www.crystallography.net/cod/result?id=1000007,1000008&text=quartz&formula=C8 H10 N4 O2&el1=Si&el2=O&spacegroup=F m -3 m&space_group_number=225&limit=10 |
|
| Search crystal structures | probe-gate |
https://www.crystallography.net/cod/result?format=html&id=1000007%2C1000008&text=quartz&formula=C8+H10+N4+O2&el1=Si&el2=O&spacegroup=F+m+-3+m&space_group_number=225&limit=10 |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:38:52.121508 | 200 | 253ms | |
| 2026-03-23 10:37:23.945673 | 404 | 104ms | |
| 2026-03-23 10:33:43.729801 | 404 | 93ms | |
| 2026-03-23 10:20:28.285730 | 404 | 232ms | |
| 2026-03-23 09:10:20.789289 | 200 | 459ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:20:28.285730 | b379432d8ede |
53ed48d10c5d |
| 2026-03-23 10:38:52.121508 | 53ed48d10c5d |
f27dfd93471b |