FAIRsharing Data Access
APIs for querying and modifying FAIRsharing records on api.fairsharing.org.
Last updated
Was this helpful?
APIs for querying and modifying FAIRsharing records on api.fairsharing.org.
Last updated
Was this helpful?
A REST API is available which permits querying, creating and updating records in FAIRsharing. In order to use it an account is required; if you have signed in using a service such as ORCID you'll need to create a password and authenticate to the API via your FAIRsharing username/password.
The terms of use of the REST API can be found here. Currently, documentation is available on the main FAIRsharing site, though we may also add some here at a later date.
There's an OAI-PMH endpoint available at https://api.fairsharing.org/oai. This is currently a work in progress and further fields may be added to the output later. Here are some example queries: List records:
Display a single record:
In addition to the REST API above, it's possible to request information directly from our site in machine-readable format, without using https://api.fairsharing.org. If a request for the headers of a page is made the information will be embeded there showing what links/data formats are available. For example:
...will return the following links in its header information:
The first of these links shows how to cite the record. The second two describe how to obtain information about the record in either JSON or JSON+LD format. The first of these formats will contain the record's entire metadata field.
To access data in one of these formats the following command can be used:
This feature doesn't offer any means to search or modify records, but could be useful for anyone needing to quickly access machine-readable data from our website's pages.
As with our API, the licence terms for the use of our data are included in the response (https://creativecommons.org/licenses/by-sa/4.0/).
You can find more out about signposting in this EOSC report:
Wilkinson, M., Sansone, S.-A., Grootveld, M., Dennis, R., Hecker, D., Huber, R., Soiland-Reyes, S., Van de Sompel, H., Czerniak, A., Thurston, M., Lister, A., & Gaignard, A. (2024). Report on FAIR Signposting and its Uptake by the Community. Zenodo. https://doi.org/10.5281/zenodo.10490289