Olive oil

Evolution of up to 7 different product categories in more than 20 different markets across the major oil-producing Member States, with some of the data series going back as far as June 2010. Annual and monthly gross production and end-of-year stocks of olive oil per Member State.

More information can be found on the portal’s olive oil prices app and olive oil production app.

As for olive oil production results are ordered in the following manner :

Production Year in reverse chronological order
Member State name in alphabetical order

SUB-SECTIONS:

Olive oil prices Olive oil products Olive oil markets Olive oil member states

Olive oil annual production volumes Olive oil monthly production volumes

Olive oil prices

Request parameters

Parameter	Optional	Description
memberStateCodes	true	The optional codes of the EU Member States.
marketingYears	true	The optional marketingYears(s) must be in format yyyy/yyyy to search for olive oil prices.
products	true	The optional product(s) of an olive oil.
markets	true	The optional market(s) to search for an olive oil.
weeks	true	The optional week(s) to search for olive oil prices.
beginDate	true	The optional date interval start to search for olive oil prices.
endDate	true	The optional date interval end to search for olive oil prices.

Parameter

Optional

Description

memberStateCodes

true

The optional codes of the EU Member States.

marketingYears

true

The optional marketingYears(s) must be in format yyyy/yyyy to search for olive oil prices.

products

true

The optional product(s) of an olive oil.

markets

true

The optional market(s) to search for an olive oil.

weeks

true

The optional week(s) to search for olive oil prices.

beginDate

true

The optional date interval start to search for olive oil prices.

endDate

true

The optional date interval end to search for olive oil prices.

Example of a request

GET /api/oliveOil/prices?memberStateCodes=PT&beginDate=07/02/2021&endDate=15/02/2021&products=Extra%20virgin%20olive%20oil%20(up%20to%200.8%25)&markets=Alentejo%20Norte HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with olive oil 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 olive oil price.
`[].endDate`	`String`	The valid end date period of the olive oil price.
`[].weekNumber`	`Number`	The week number of the year.
`[].marketingYear`	`String`	The marketing year of the olive oil price.
`[].product`	`String`	The product name of the olive oil.
`[].market`	`String`	The market name of the olive oil.
`[].unit`	`String`	The unit of the olive oil.
`[].price`	`String`	The price of the olive oil.

[]

Array

Array with olive oil 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 olive oil price.

[].endDate

String

The valid end date period of the olive oil price.

[].weekNumber

Number

The week number of the year.

[].marketingYear

String

The marketing year of the olive oil price.

[].product

String

The product name of the olive oil.

[].market

String

The market name of the olive oil.

[].unit

String

The unit of the olive oil.

[].price

String

The price of the olive oil.

Example of a response

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

[ {
   "memberStateCode" : "PT",
   "memberStateName" : "Portugal",
   "beginDate" : "08/02/2021",
   "endDate" : "14/02/2021",
   "weekNumber" : 20,
   "price" : "€275.00",
   "unit" : "€/100kg",
   "product" : "Extra virgin olive oil (up to 0.8%)",
   "market" : "Alentejo Norte",
   "marketingYear" : "2020/2021"
} ]

Olive oil products

Example of a request

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

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with olive oil products

[]

Array

Array with olive oil products

Example of a response

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

[ "Lampante olive oil (2%)", "Virgin olive oil (up to 2%)" ]

Olive oil markets

Example of a request

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

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with olive oil markets

[]

Array

Array with olive oil markets

Example of a response

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

[ "Alentejo Sul", "Alentejo Norte", "Palermo (ITG12)" ]

Olive oil member states

Example of a request

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

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with member states producing olive oil.

[]

Array

Array with member states producing olive oil.

Example of a response

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

[ "Italy", "Spain" ]

Olive oil annual production volumes

Request parameters

Parameter	Optional	Description
memberStateCodes	true	The optional codes of the EU Member States.
marketingYears	true	The optional marketing year(s) must be in format yyyy/yy to search for olive oil production volumes.
granularity	false	The mandatory granularity parameter must be either 'annual' or 'monthly'.
productionYears	true	The optional production year(s) must be in format yyyy to search for olive oil.

Parameter

Optional

Description

memberStateCodes

true

The optional codes of the EU Member States.

marketingYears

true

The optional marketing year(s) must be in format yyyy/yy to search for olive oil production volumes.

granularity

false

The mandatory granularity parameter must be either 'annual' or 'monthly'.

productionYears

true

The optional production year(s) must be in format yyyy to search for olive oil.

Example of a request

GET /api/oliveOil/production?memberStateCodes=PT&granularity=annual&productionYears=2018 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with olive oil annual production
`[].memberStateCode`	`String`	The code of the EU Member State.
`[].memberStateName`	`String`	The name of the EU Member State.
`[].marketingYear`	`String`	The marketing year of the olive oil production volume.
`[].productionYear`	`Number`	The production year of the olive oil production volume.
`[].endingStockQuantity`	`Number`	The ending stock quantity of the olive oil production volume.
`[].yearProductionQuantity`	`Number`	The year production quantity of the olive oil production volume.
`[].isEstimated`	`String`	The flag to indicate that the production quantity is estimated (Y) or not (N).

[]

Array

Array with olive oil annual production

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].marketingYear

String

The marketing year of the olive oil production volume.

[].productionYear

Number

The production year of the olive oil production volume.

[].endingStockQuantity

Number

The ending stock quantity of the olive oil production volume.

[].yearProductionQuantity

Number

The year production quantity of the olive oil production volume.

[].isEstimated

String

The flag to indicate that the production quantity is estimated (Y) or not (N).

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "marketingYear" : "2018/19",
  "productionYear" : 2018,
  "yearProductionQuantity" : 100.32,
  "endingStockQuantity" : 0.0,
  "isEstimated" : "N"
} ]

Olive oil monthly production volumes

Request parameters

Parameter	Optional	Description
memberStateCodes	true	The optional codes of the EU Member States.
marketingYears	true	The optional marketing year(s) must be in format yyyy/yy to search for olive oil production volumes.
granularity	false	The mandatory granularity parameter must be either 'annual' or 'monthly'.
productionYears	true	The optional production year(s) must be in format yyyy to search for olive oil.
months	true	The optional production month(s) parameter is only used for granularity 'monthly'.

Parameter

Optional

Description

memberStateCodes

true

The optional codes of the EU Member States.

marketingYears

true

The optional marketing year(s) must be in format yyyy/yy to search for olive oil production volumes.

granularity

false

The mandatory granularity parameter must be either 'annual' or 'monthly'.

productionYears

true

The optional production year(s) must be in format yyyy to search for olive oil.

months

true

The optional production month(s) parameter is only used for granularity 'monthly'.

Example of a request

GET /api/oliveOil/production?memberStateCodes=IT&granularity=monthly&productionYears=2018&months=1 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with olive oil monthly production
`[].memberStateCode`	`String`	The code of the EU Member State.
`[].memberStateName`	`String`	The name of the EU Member State.
`[].marketingYear`	`String`	The marketing year of the olive oil production volume.
`[].productionYear`	`Number`	The production year of the olive oil production volume.
`[].productionMonth`	`String`	The production month of the olive oil production volume.
`[].monthProductionQuantity`	`Number`	The month quantity of the olive oil production volume.

[]

Array

Array with olive oil monthly production

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].marketingYear

String

The marketing year of the olive oil production volume.

[].productionYear

Number

The production year of the olive oil production volume.

[].productionMonth

String

The production month of the olive oil production volume.

[].monthProductionQuantity

Number

The month quantity of the olive oil production volume.

Example of a response

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

[ {
  "memberStateCode" : "IT",
  "memberStateName" : "Italy",
  "marketingYear" : "2018/19",
  "productionYear" : 2018,
  "productionMonth" : "January",
  "monthProductionQuantity" : 2.96
} ]