mp_api.client.routes.molecules.molecules.MoleculeRester

class mp_api.client.routes.molecules.molecules.MoleculeRester(**kwargs)

Bases: CoreRester

Ensure that sub resters are unset on re-init.

__init__(**kwargs)

Ensure that sub resters are unset on re-init.

Methods

__init__(**kwargs)	Ensure that sub resters are unset on re-init.
available_db_versions()	Database versions available for this collection's full dataset on S3.
count([criteria])	Return a count of total documents.
get_data_by_id(document_id[, fields])

Attributes

available_fields
delta_backed
delta_catalog	The DeltaCatalog used for delta-backed queries, created on first use.
primary_key
query_builder	use delta_catalog.
s3_client
session
suffix

document_model

alias of MoleculeDoc

available_db_versions() → list[str]

Database versions available for this collection’s full dataset on S3.

Read from the DeltaTable’s log, no data is downloaded. Any of these can be pinned with MPRester(db_version=…) to download that version of the dataset.

Returns:

sorted database versions, e.g. [“2026.04.13”, “2026.09.28”]

Return type:

list of str

Raises:

MPRestError – if this collection isn’t delta-backed, or its dataset isn’t partitioned by database version.

count(criteria: dict | None = None) → int

Return a count of total documents.

Parameters:

criteria (dict | None) – As in .search(). Defaults to None

Returns:

Count of total results

Return type:

int

property delta_catalog: DeltaCatalog

The DeltaCatalog used for delta-backed queries, created on first use.

property query_builder: QueryBuilderWithCache

use delta_catalog.

Type:

Deprecated