GET /result

crystallography.net:cod-api

Summary: Search crystal structures
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)

alpmax (number, query, optional)

Maximum value for lattice angle alpha (in degrees)

alpmin (number, query, optional)

Minimum value for lattice angle alpha (in degrees)

amax (number, query, optional)

Maximum value for lattice parameter a (in Angstroms)

amin (number, query, optional)

Minimum value for lattice parameter a (in Angstroms)

betmax (number, query, optional)

Maximum value for lattice angle beta (in degrees)

betmin (number, query, optional)

Minimum value for lattice angle beta (in degrees)

bmax (number, query, optional)

Maximum value for lattice parameter b (in Angstroms)

bmin (number, query, optional)

Minimum value for lattice parameter b (in Angstroms)

cmax (number, query, optional)

Maximum value for lattice parameter c (in Angstroms)

cmin (number, query, optional)

Minimum value for lattice parameter c (in Angstroms)

doi (string, query, optional)

DOI (Digital Object Identifier) of the publication

el1 (string, query, optional)

First element that must be present in the structure

el2 (string, query, optional)

Second element that must be present in the structure

el3 (string, query, optional)

Third element that must be present in the structure

el4 (string, query, optional)

Fourth element that must be present in the structure

el5 (string, query, optional)

Fifth element that must be present in the structure

el6 (string, query, optional)

Sixth element that must be present in the structure

el7 (string, query, optional)

Seventh element that must be present in the structure

el8 (string, query, optional)

Eighth element that must be present in the structure

format (string, query, optional, default: html)

Output format for search results

Constraints: {'enum': ['json', 'html', 'csv', 'lst', 'urls', 'zip', 'count']}

formula (string, query, optional)

Chemical formula in Hill notation (e.g., 'C8 H10 N4 O2' for caffeine)

gamax (number, query, optional)

Maximum value for lattice angle gamma (in degrees)

gamin (number, query, optional)

Minimum value for lattice angle gamma (in degrees)

has_fobs (integer, query, optional)

Filter for entries with X-ray reflection files (structure factor data)

Constraints: {'enum': [0, 1]}

id (string, query, optional)

COD ID(s) to search for. Multiple IDs can be separated by commas or new lines. Use % as wildcard.

include_duplicates (integer, query, optional)

Include duplicate entries in results

Constraints: {'enum': [0, 1]}

include_errors (integer, query, optional)

Include entries with errors in results

Constraints: {'enum': [0, 1]}

include_theoretical (integer, query, optional)

Include theoretical/predicted structures in results

Constraints: {'enum': [0, 1]}

issue (string, query, optional)

Journal issue

journal (string, query, optional)

Journal name for publication search

limit (integer, query, optional)

Maximum number of results to return

maxZ (integer, query, optional)

Maximum Z value (number of formula units per unit cell)

maxZprime (number, query, optional)

Maximum Z' value

minZ (integer, query, optional)

Minimum Z value (number of formula units per unit cell)

minZprime (number, query, optional)

Minimum Z' value

nel1 (string, query, optional)

First element that must NOT be present in the structure

nel2 (string, query, optional)

Second element that must NOT be present in the structure

nel3 (string, query, optional)

Third element that must NOT be present in the structure

nel4 (string, query, optional)

Fourth element that must NOT be present in the structure

smarts (string, query, optional)

Substructure query in SMARTS notation

space_group_number (integer, query, optional)

Space group number from International Tables for Crystallography Vol. A

spacegroup (string, query, optional)

Space group symbol in Hermann-Mauguin notation

strictmax (integer, query, optional)

Maximum number of distinct elements

strictmin (integer, query, optional)

Minimum number of distinct elements

text (string, query, optional)

Text search in metadata including bibliographic info, compound names, and mineral names

vmax (number, query, optional)

Maximum unit cell volume (in cubic Angstroms)

vmin (number, query, optional)

Minimum unit cell volume (in cubic Angstroms)

volume (string, query, optional)

Journal volume

year (integer, query, optional)

Publication year

Examples (5)

TitleTypeURLAction
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

Latency

Status Codes

TimeStatusLatencySize
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

WhenOldNew
2026-03-23 10:20:28.285730 b379432d8ede 53ed48d10c5d
2026-03-23 10:38:52.121508 53ed48d10c5d f27dfd93471b