Wine Quality API

🔴 1,599 red wines ⚪ 4,898 white wines 6,497 total records — 11 physicochemical features + quality score (0–10)

Browse the full interactive docs at /docs.

Endpoints

MethodPathWhat it returns
GET/winesPaginated list of all wines (filter by type & quality)
GET/wines/redRed wine records only
GET/wines/whiteWhite wine records only
GET/wines/statsSummary statistics (mean, min, max) by wine type
GET/wines/quality-distributionCount of wines at each quality score

Query parameters for /wines

ParameterTypeExampleDescription
typestringredred or white
min_qualityinteger7Minimum quality score (0–10)
max_qualityinteger9Maximum quality score (0–10)
limitinteger50Records per page (default 50, max 500)
offsetinteger100Skip this many records (for paging)

Fields returned per wine

FieldUnit / notes
fixed acidityg/dm³
volatile acidityg/dm³ — high values give vinegar taste
citric acidg/dm³
residual sugarg/dm³ — sugar remaining after fermentation
chloridesg/dm³ — salt content
free sulfur dioxidemg/dm³
total sulfur dioxidemg/dm³
densityg/cm³
pH0–14 scale
sulphatesg/dm³
alcohol% by volume
qualityScore 0–10 (expert rating)
typered or white