Wine

Prices of different classes of wine from France, Germany, Italy and Spain, with some of the time series ranging back to 2009. More information can be found on the Info tab of the portal’s wine prices app.
SUB-SECTIONS:
Wine prices Wine descriptions

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

descriptions

true

The optional wine descriptions(s). Multiple categories must be comma-separated. For more details check the REST API : /api/wine/descriptions

years

true

The optional year(s) to search for wine.

months

true

The optional month(s) to search for wine.

weeks

true

The optional week(s) of a marketing year to search for wine. The first week of August is number 1.

beginDate

true

The optional date interval start to search for wine prices.

endDate

true

The optional date interval end to search for wine prices.

Example of a request

GET /api/wine/prices?memberStateCodes=PT,ES&beginDate=22/01/2019&endDate=22/04/2020 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

[]

Array

Array with wine prices

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].beginDate

String

The valid start date period of the wine price.

[].endDate

String

The valid end date period of the wine price.

[].weekNumber

Number

The week number of the year.

[].description

String

The description of the wine.

[].unit

String

The unit of the wine.

[].price

String

The price of the wine.

Example of a response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 232

[ {
  "memberStateCode" : "IT",
  "memberStateName" : "Italy",
  "beginDate" : "23/11/2018",
  "endDate" : "30/12/2018",
  "weekNumber" : 5,
  "price" : "€90.00",
  "unit" : "Euro / HL.",
  "description" : "Verona Vino bianco DOP"
} ]

Wine descriptions

Example of a request

GET /api/wine/descriptions HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

[]

Array

Array with Wine descriptions

[].description

String

The description of the wine.

Example of a response

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 86

[ {
  "description" : "Blancs / Vin AOP"
}, {
  "description" : "Blancs / VIP IGP"
} ]