Materials Project Documentation
Return to materialsproject.org
Search…
Materials Project Documentation
Introduction
Frequently Asked Questions
Getting Involved
Getting Help
Database Versions
Changes
Code of Conduct
Methodology
Calculation Details
Thermodynamic Stability
Equations of State
Electronic Structure
Phonon Dispersion
Diffraction Patterns
Aqueous Stability (Pourbaix)
Magnetic Properties
Elastic Constants
Dielectric Constants
Piezoelectric Constants
X-ray Absorption Spectra
Surface Energies
Suggested Substrates
Grain Boundaries
Related Materials
Apps
Catalysis Explorer
MOF Explorer
Battery Explorer
Molecules Explorer
Synthesis Explorer
Downloading Data
How do I download the Materials Project database?
Differences between new and legacy API
Using the API
API Endpoint Documentation
Uploading Data
What is MPContribs?
Powered By GitBook
Differences between new and legacy API
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
API Key
​Available here ​
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 import MPRester
from pymatgen.ext.matproj import MPRester
MPContribs integration for user contributed data
Yes
No
Downloading Data - Previous
How do I download the Materials Project database?
Next - Downloading Data
Using the API
Last modified 4mo ago
Export as PDF
Copy link
Edit on GitHub