Advanced Usage
Information for advanced users of the API.
In addition the search, an alternative approach to querying data is with the underlying _search function. Instead of using input parameters defined in the client, direct API query parameters are used instead. Documentation on which of these are available for each endpoint can be found here or in the API endpoint documentation sections. While this information is provided, most people can and should stick to using the standard search function.
The code below is an example illustrating the difference in querying for data from the summary endpoint with volume criteria using search and _search:
1
from mp_api import MPRester
2
3
with MPRester("your_api_key_here") as mpr:
4
# -- Using 'search'
5
docs = mpr.summary.search(volume=(3,10))
6
7
# -- Using '_search'
8
docs = mpr.summary._search(volume_min=3, volume_max=10)
Copied!
Relevant Code Links
api/client.py at main · materialsproject/api
GitHub
_search method.
Export as PDF
Copy link
Edit on GitHub