Sugar

Evolution of 3 sugar region prices, with data series going back as far as January 2018. More information can be found on the portal’s sugar prices app and sugar production app.

Prices results are ordered in the following manner :
  1. Marketing Year/Month in reverse chronological order
  2. Region in alphabetical order

As for sugar production, results are ordered in the following manner :
  1. Marketing Year in reverse chronological order
  2. Region in reverse alphabetical order
SUB-SECTIONS:
Sugar prices Sugar regions
Sugar production volumes Sugar production regions

Request parameters

Parameter Optional Description

regions

true

The optional sugar regions of the EU.

yms

true

The optional marketing year/month of a sugar price must be in format yyyy/mm.

marketingYears

true

The optional marketing year(s) of a sugar price.

months

true

The optional marketing month(s) parameter of a sugar price. Only numbers are accepted.

contractTypes

true

The optional contract type(s) parameter must be either 'monthly' or 'short'.

Example of a request

GET /api/sugar/prices?marketingYears=2020/2021&yms=2020/10&regions=EU%20Average HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json

Response fields

Path Type Description

[]

Array

Array with sugar prices

[].sugarRegion

String

The region of the EU to which a sugar price belongs to.

[].marketingYear

String

The marketing year of the sugar price.

[].ym

String

The Year/Month of the sugar price.

[].marketingYearMonth

String

The month of the marketing year of the sugar price.

[].contractType

String

The contract type of the sugar price.

[].weight

Number

The weight in tonnes of the sugar price.

[].unit

String

The unit of the sugar price.

[].price

String

The price of the sugar good.

Example of a response

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

 [ {
   "sugarRegion" : "Region EU Average",
   "price" : "€308.56",
   "unit" : "Tonne",
   "ym" : "2020-10",
   "marketingYear" : "2020/2021",
   "marketingYearMonth" : "October",
   "weight" : 82592.06,
   "contractType" : "Monthly data"
 } ]

Sugar regions

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with sugar regions

Example of a response

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

[ "EU Average", "Region 1", "Region 2", "Region 3" ]

Request parameters

Parameter Optional Description

marketingYears

true

The optional marketing year(s) to search for sugar production volumes.

regions

true

The optional sugar region(s). Multiple regions must be comma-separated. For more details check the REST API : /api/sugar/production/regions

Example of a request

GET /api/sugar/production?marketingYears=2020/21&regions=Region 1 HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json

Response fields

Path Type Description

[]

Array

Array with sugar production volumes.

[].region

String

The region of the EU to which a sugar production volumes belongs to.

[].marketingYear

String

The marketing year of the sugar production volume.

[].area

Number

The volume area of sugar beet.

[].areaUnit

String

The unit of the area.

[].grossProduction

Number

The gross amount of sugar production for white sugar equivalent.

[].grossProductionUnit

String

The unit of the gross production.

[].yield

Number

The yield, which divides gross production and area, for white sugar.

[].yieldUnit

String

The unit of the yield.

Example of a response

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

 [ {
  "marketingYear" : "2020/21",
  "region" : "Region 1",
  "grossProduction" : 4025045.73,
  "grossProductionUnit" : "tonnes",
  "area" : 461.65,
  "areaUnit" : "thousand hectares",
  "yield" : 8.72,
  "yieldUnit" : "tonnes per hectare"
} ]

Sugar production regions

Example of a request

GET /api/sugar/production/regions HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json

Response fields

Path Type Description

[]

Array

Array with sugar production regions

Example of a response

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

[ "Region 1", "Region 2", "Region 3" ]