Differences between new and legacy API
Comparison between the old (legacy) and new Materials Project (MP) APIs.
A summary of differences between the new and legacy API can be found in the table below. For more detailed information on differences regarding the Python API client, please see the Legacy API Users section.
New API
Legacy API
Currently recommended for
Early adopters
Everyone else
Base URL
api.materialsproject.org
materialsproject.org/rest/v2
Documentation
mapidoc
Specification
None available
Support
Our new API will be supported for the forseeable future once released
Will be available for at least one year after new API is finalized
Data Updates
Will receive new data updates included latest and most accurate data
Will be frozen at database release v2021.03.13
Python client installation
pip install mp-api (may be available in pymatgen at a later date)
pip install pymatgen
Python client import code
from mp_api.client import MPRester
from pymatgen.ext.matproj import MPRester
MPContribs integration for user contributed data
Yes
No
Export as PDF
Copy link
Edit on GitHub