Materials Project Documentation
Return to materialsproject.org
Search…
Materials Project Documentation
Introduction
Frequently Asked Questions (FAQ)
Changes and Updates
Documentation Credit
Community
Getting Help
Getting Involved
Community Resources
Code of Conduct
Services
MPContribs
Methodology
Materials Methodology
Molecules Methodology
MOF Methodology
Apps
Explore and Search Apps
Analysis Apps
Characterization Apps
Explore Contributed Data
Downloading Data
How do I download the Materials Project database?
Using the API
Differences between new and legacy API
Query and Download Contributed Data
Uploading Data
Contribute Data
Data Production
Data Workflows
Data Builders
Powered By GitBook
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
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
Previous
Deprecated Materials
Next - Downloading Data
Query and Download Contributed Data
Last modified 25d ago
Export as PDF
Copy link
Edit on GitHub