Fruit and vegetables

Fruit And Vegetables

IMPORTANT NOTE

The fruit and vegetable prices API is not receiving updated figures and will be decommissioned in the first half of 2025.

The successor fruit and vegetables supply chain prices API has been released, it contains the fruit and vegetables prices for all the stages (Ex-packaging, Farmgate, and Retail).

Times series of average fruit and vegetables prices and supply chain prices per Member State and for the European Union (not for supply chain prices), showing prices in the full range from 2005 and 2010 respectively. More information can be found on the Info tab of the portal’s fruit and vegetables prices (supply chain) app.

As for fruit and vegetables supply chain prices are ordered in the following manner:

Begin date in reverse chronological order
End date in chronological order
Member state name in alphabetical order
Variety in alphabetical order
Product stage in alphabetical order

SUB-SECTIONS:

Fruit and vegetable prices Fruit and vegetable products Fruit and vegetable varieties

Fruit and vegetable supply chain prices Fruit and vegetable supply chain prices product stages Fruit and vegetable supply chain prices products Fruit and vegetable supply chain prices varieties

Fruit and vegetable prices

Request parameters

Parameter	Optional	Description
memberStateCodes	true	The optional codes of the EU Member States.
calendarYears	true	The optional calendar year(s) to search for fruit and vegetable prices.
months	true	The optional month(s) to search for fruit and vegetable.
weeks	true	The optional week(s) of a year to search for fruit and vegetable. The first week of January is number 1.
beginDate	true	The optional date interval start to search for fruit and vegetable prices.
endDate	true	The optional date interval end to search for fruit and vegetable prices.
products	true	The optional product(s) to search for fruit and vegetable prices.
varieties	true	The optional variety(ies) to search for fruit and vegetable prices.

Parameter

Optional

Description

memberStateCodes

true

The optional codes of the EU Member States.

calendarYears

true

The optional calendar year(s) to search for fruit and vegetable prices.

months

true

The optional month(s) to search for fruit and vegetable.

weeks

true

The optional week(s) of a year to search for fruit and vegetable. The first week of January is number 1.

beginDate

true

The optional date interval start to search for fruit and vegetable prices.

endDate

true

The optional date interval end to search for fruit and vegetable prices.

products

true

The optional product(s) to search for fruit and vegetable prices.

varieties

true

The optional variety(ies) to search for fruit and vegetable prices.

Example of a request

GET /api/fruitAndVegetable/prices?memberStateCodes=PT,SI&products=oranges&months=1,2,3&beginDate=12/02/2018&endDate=23/03/2020 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with fruit and vegetable 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 fruit and vegetable price.
`[].endDate`	`String`	The valid end date period of the fruit and vegetable price.
`[].weekNumber`	`Number`	The week number of the year.
`[].product`	`String`	The product of the fruit and vegetable.
`[].variety`	`String`	The variety of the fruit and vegetable.
`[].description`	`String`	The description of the fruit and vegetable.
`[].unit`	`String`	The unit of the fruit and vegetable.
`[].price`	`String`	The price of the fruit and vegetable.

[]

Array

Array with fruit and vegetable 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 fruit and vegetable price.

[].endDate

String

The valid end date period of the fruit and vegetable price.

[].weekNumber

Number

The week number of the year.

[].product

String

The product of the fruit and vegetable.

[].variety

String

The variety of the fruit and vegetable.

[].description

String

The description of the fruit and vegetable.

[].unit

String

The unit of the fruit and vegetable.

[].price

String

The price of the fruit and vegetable.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "23/03/2019",
  "endDate" : "30/04/2019",
  "weekNumber" : 5,
  "price" : "€180.17",
  "unit" : "100 KG",
  "product" : "oranges",
  "variety" : "all types and varieties",
  "description" : "Portugal - oranges - navel"
} ]

Fruit and vegetable products

Example of a request

GET /api/fruitAndVegetable/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 Fruit and Vegetable products
`[].product`	`String`	The name of the product.
`[].productGroupCode`	`String`	The product group code of the fruit and vegetable.

[]

Array

Array with Fruit and Vegetable products

[].product

String

The name of the product.

[].productGroupCode

String

The product group code of the fruit and vegetable.

Example of a response

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

[ {
  "product" : "strawberries",
  "productGroupCode" : "FRA"
}, {
  "product" : "apples",
  "productGroupCode" : "POM"
} ]

Fruit and vegetable varieties

Example of a request

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

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with Fruit and Vegetable varieties
`[].variety`	`String`	The name of the variety.
`[].productName`	`String`	The name of the product.
`[].productCode`	`String`	The code of the product.
`[].productGroupCode`	`String`	The product group code of the fruit and vegetable.

[]

Array

Array with Fruit and Vegetable varieties

[].variety

String

The name of the variety.

[].productName

String

The name of the product.

[].productCode

String

The code of the product.

[].productGroupCode

String

The product group code of the fruit and vegetable.

Example of a response

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

[ {
  "variety" : "All types and varieties",
  "productName" : "strawberries",
  "productCode" : "FRACL1",
  "productGroupCode" : "FRA"
}, {
  "variety" : "Fuji - Cat. I - Cal. 70-80",
  "productName" : "apples",
  "productCode" : "POMFUJ",
  "productGroupCode" : "POM"
} ]

Fruit and vegetable supply chain prices

Request parameters

Parameter	Optional	Description
memberStateCodes	true	The optional codes of the EU Member States.
years	true	The optional year(s) to search for fruit and vegetable supply chain prices.
beginDate	true	The optional date interval start to search for fruit and vegetable supply chain prices.
endDate	true	The optional date interval end to search for fruit and vegetable supply chain prices.
productStages	true	The optional product stage(s) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/productStages
products	true	The optional product(s) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/products
varieties	true	The optional variety(ies) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/varieties

Parameter

Optional

Description

memberStateCodes

true

The optional codes of the EU Member States.

years

true

The optional year(s) to search for fruit and vegetable supply chain prices.

beginDate

true

The optional date interval start to search for fruit and vegetable supply chain prices.

endDate

true

The optional date interval end to search for fruit and vegetable supply chain prices.

productStages

true

The optional product stage(s) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/productStages

products

true

The optional product(s) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/products

varieties

true

The optional variety(ies) to search for fruit and vegetable supply chain prices. For more details check the REST API : /api/fruitAndVegetable/pricesSupplyChain/varieties

Example of a request

GET /api/fruitAndVegetable/pricesSupplyChain?years=2021,2022&memberStateCodes=AT&beginDate=01/01/2022&endDate=06/02/2022&products=oranges HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with fruit and vegetable supply chain 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 fruit and vegetable supply chain price.
`[].endDate`	`String`	The valid end date period of the fruit and vegetable supply chain price.
`[].price`	`String`	The price of the fruit and vegetable supply chain price.
`[].unit`	`String`	The unit of the fruit and vegetable supply chain price.
`[].periodType`	`String`	The type (Week, Month, Third, Year) of the period of the fruit and vegetable supply chain price.
`[].period`	`Number`	The number of the period of the fruit and vegetable supply chain price.
`[].year`	`Number`	The year of the fruit and vegetable supply chain price.
`[].variety`	`String`	The variety of the fruit and vegetable supply chain price.
`[].productStage`	`String`	The product stage of the fruit and vegetable supply chain price.
`[].market`	`String`	The market of the fruit and vegetable supply chain price.
`[].isCalculated`	`String`	The flag to indicate that the fruit and vegetable supply chain price is calculated (Y) or not (N).
`[].isRegulated`	`String`	The flag to indicate that the fruit and vegetable supply chain price is regulated (Y) or not (N).

[]

Array

Array with fruit and vegetable supply chain 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 fruit and vegetable supply chain price.

[].endDate

String

The valid end date period of the fruit and vegetable supply chain price.

[].price

String

The price of the fruit and vegetable supply chain price.

[].unit

String

The unit of the fruit and vegetable supply chain price.

[].periodType

String

The type (Week, Month, Third, Year) of the period of the fruit and vegetable supply chain price.

[].period

Number

The number of the period of the fruit and vegetable supply chain price.

[].year

Number

The year of the fruit and vegetable supply chain price.

[].variety

String

The variety of the fruit and vegetable supply chain price.

[].productStage

String

The product stage of the fruit and vegetable supply chain price.

[].market

String

The market of the fruit and vegetable supply chain price.

[].isCalculated

String

The flag to indicate that the fruit and vegetable supply chain price is calculated (Y) or not (N).

[].isRegulated

String

The flag to indicate that the fruit and vegetable supply chain price is regulated (Y) or not (N).

Example of a response

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

[ {
  "memberStateCode" : "AT",
  "memberStateName" : "Austria",
  "beginDate" : "31/01/2022",
  "endDate" : "06/02/2022",
  "price" : "€155.51",
  "unit" : "€/100Kg",
  "periodType" : "Week",
  "period" : 5,
  "year" : 2022,
  "variety" : "Oranges - Navel",
  "productStage" : "Retail buying price",
  "market" : "National average (AT)",
  "isCalculated" : "N",
  "isRegulated" : "Y"
} ]

Fruit and vegetable supply chain prices product stages

Example of a request

GET /api/fruitAndVegetable/pricesSupplyChain/productStages HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with fruit and vegetable supply chain product stages

[]

Array

Array with fruit and vegetable supply chain product stages

Example of a response

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

[ "Ex-packaging station price", "Farmgate price", "Retail buying price" ]

Fruit and vegetable supply chain prices products

Example of a request

GET /api/fruitAndVegetable/pricesSupplyChain/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 fruit and vegetable supply chain products

[]

Array

Array with fruit and vegetable supply chain products

Example of a response

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

[ "Apples", "Apples for processing", "Apricots", "Asparagus", "Avocados", "Bananas", "Beans" ]

Fruit and vegetable supply chain prices varieties

Example of a request

GET /api/fruitAndVegetable/pricesSupplyChain/varieties HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

Path	Type	Description
`[]`	`Array`	Array with fruit and vegetable supply chain varieties

[]

Array

Array with fruit and vegetable supply chain varieties

Example of a response

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

[ "Apples - All types and varieties", "Apples - Boskoop", "Apples - Braeburn", "Apples - Cox orange", "Apples - Elstar", "Apples - Fuji", "Apples - Gala" ]