EssOilDB 2.0
Home Profiles Search Statistics About Contact Us Geolocation FAIR Data Cite Us

FAIR Data

This database follows FAIR principles — Findable, Accessible, Interoperable, Reusable. All data below is free to download and reuse via file export or the public API.

API Reference

Base URL: http://223.31.159.20/api

GET /species/<species_name>

Returns all composition records for one species as JSON.

curl "http://223.31.159.20/api/species/Abies%20alba"
GET /family/<family_name>

Returns all composition records for one plant family as JSON.

GET /compound/<compound_name>

Returns all records containing a given compound, across species.

GET /plantpart/<part_name>

Returns all records for a given plant part (e.g. leaf, root, flower).

GET /download/csv/<species_name>

Downloads a CSV file of one species' composition data.

GET /download/excel/<species_name>

Downloads an Excel (.xlsx) file of one species' composition data.

GET /search?q=<term>

Search species/genus by partial name match, returns JSON.

GET /download/csv?q=<term>

Bulk CSV export for all species/genera matching the search term.

GET /download/sql

Full database dump (all 13 tables, structure + data) as a .sql file. Limited to 3 requests/hour per IP.

GET /download/sql/<table_name>

Single-table SQL dump. Valid tables: bibliography, chemicalgroup, compoundactivity, compounddata, expcondition, expmethodology, infocdata, infopdata, location, plantdata, plantfamily, planthabit, plantpart

Rate limits apply per IP address (roughly 15–30 requests/minute on data endpoints, lower on full SQL dumps).

Documentation generated 2026-07-28.

Academic License

The Academic License is free and available for researchers who meet the following criteria:

Sign up here

Thank you for your patience and continued support of the EssOilDB database. When using EssOilDB datasets for academic research, please cite EssOilDB in any resulting publications — see the Cite Us page.