General information

What is it about?

An API, short for Application Programming Interface, is a set of services that can be called from a computer program (“Machine to Machine” interface). It's a computer interface, as opposed to a (human) graphical user interface. Technically the Agri-food Data API is a Web API, consisting of a set of addresses (URLs) that may be used to retrieve information from the portal's database. The information is substantially the same as what you can see in the "Data Explorer" tab of the corresponding portal app, but the format is suitable for consumption by computers rather than human beings – even though humans can still read it! It is formatted in a structure known as JSON.

Here is an example of a query URL to retrieve some Portuguese beef prices from 2019 and 2020:


The key=value pairs after the question mark are filtering parameters to limit the reply to only those records that you need. If you click on that link you will see a typical JSON-formatted reply with curly braces {} to separate records. You can also experiment by varying the parameter values in the address bar of your browser. The general structure of a request is:



Where host_URL is the fixed address of our API server, service is the name of the particular web service, and filters is a series of parameter-based restrictions separated by & signs. The available filter parameters depend on the service, as described in later sections of this document.

Using your favourite spreadsheet application

A relatively simple way of putting the API to work is by launching the query from inside a spreadsheet application. Consult the documentation of your favourite spreadsheet tool and look for something like “getting data from the Web”. Where it says "address" or "URL", paste the above URL. In some spreadsheet applications this may require writing a macro.

The sections below presuppose that you already know what a Web API is, and how to retrieve information from the JSON-formatted reply.

Agri-food Data API Guide

Overview

This describes the resources that make up the official Public Agri-food Data API.

All APIs can be found under /api.

HTTP verbs

Agri-food Data tries to adhere as closely as possible to standard HTTP and REST conventions in its use of HTTP verbs.

Verb Usage

GET

Used to retrieve a resource

Due to some limitations of the reverse proxy, some HTTP methods might be forbidden. To overcome this, you can add a _method request parameter containing the name of the desired HTTP verb. Example: ?_method=get.

HTTP status codes

Agri-food Data tries to adhere as closely as possible to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

The request completed successfully

400 Bad Request

The request was malformed. The response body will include an error providing further information

404 Not Found

The requested resource did not exist

405 Method Not Allowed

Some client parameters are incorrect. For instance, the server endpoint does not support the HTTP verb invoked by the client.

415 Unsupported Media Type

The format problem might be due to the request’s indicated Content-Type or Content-Encoding, or as a result of inspecting the data directly.

Errors

  1. Sending invalid parameters will result in a 400 Bad Request response.

  2. Trying to access a resource that does not exist will result in a 404 Not Found response.

  3. Errors or Exceptions that happened on the server will result in a 500 Internal server error response.

Whenever an error response (status code >= 400) is returned, the body will contain a JSON object that describes the problem.

The error object has the following structure if the error is generated before calling the API:

Path Type Description

error

String

The HTTP error that occurred, e.g. Not Found

message

String

A description of the cause of the error

status

Number

The HTTP status code, e.g. 404

timestamp

String

The time, in milliseconds, at which the error occurred

For example, a request that attempts to call an incorrect uri will produce a 404 Not Found response:

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 181

{
  "timestamp" : "2021-05-26T11:15:38.291+0000",
  "status" : 404,
  "error" : "Not Found",
  "message" : "The requested resource 'http://localhost:8080/api/meat' does not exist"
}

Date and time

All services return dates in dd/MM/yyyy format.

How Date filtering works

"BeginDate" and "EndDate" parameters restrict the entire week, whereas "Months" parameter only applies to the starting date of the week of the Marketing Year.

In other words "Months" is based only on "Begin Date" and this behaviour is consistent through all sectors.

Beef

Weekly prices of different categories and qualities of beef per Member State and for the whole of the Union. More information can be found on the Info tab of the portal’s beef prices app.

List all carcass categories

Example of a request

GET /api/beef/carcassCategories HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with beef carcass categories

[].description

String

The description of the carcass category.

[].productCode

String

The product code of the carcass category.

[].productGroupCode

String

The product group code of the carcass category.

[].sectorCode

String

The sector code of the carcass category.

Example of a response

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

[ {
  "description" : "Bulls",
  "productCode" : "B R3",
  "productGroupCode" : "B",
  "sectorCode" : "BOV"
} ]

Find beef prices

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

carcassCategories

true

The optional beef categories. Multiple categories must be comma-separated. For more details check the REST API : /api/beef/carcassCategories

years

true

The optional year(s) to search for beef.

weeks

true

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

months

true

The optional month(s) to search for beef.

beginDate

true

The optional date interval start to search for beef prices.

endDate

true

The optional date interval end to search for beef prices.

Example of a request

GET /api/beef/prices?memberStateCodes=PT&years=2019,2020&months=1,3,9&weeks=5,6,7,8&beginDate=22/01/2020&endDate=02/02/2020&carcassCategories=heifers,cows HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with beef prices

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].carcassCategory

String

The category of the beef carcass.

[].beginDate

String

The valid start date period of the beef price.

[].endDate

String

The valid end date period of the beef price.

[].weekNumber

Number

The week number of the year. The first week of January is number 1.

[].unit

String

The unit of the beef.

[].price

String

The price of the beef.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "23/01/2020",
  "endDate" : "30/01/2020",
  "weekNumber" : 5,
  "price" : "€20.07",
  "unit" : "100CARC",
  "carcassCategory" : "Cows"
} ]

Pigmeat

Weekly prices of different categories and qualities of pig meat as well as piglet prices per Member State and for the whole of the Union. More information can be found on the Info tab of the portal’s pigmeat prices app and piglet prices app.

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

pigClasses

true

The optional class(es) of the pigmeat are S, E, R, SE or/and Piglet and they must be comma-separated.

marketingYears

true

The optional year(s) to search for pigmeat.

months

true

The optional month(s) to search for pigmeat.

weeks

true

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

beginDate

true

The optional date interval start to search for pigmeat prices.

endDate

true

The optional date interval end to search for pigmeat prices.

Example of a request

GET /api/pigmeat/prices?memberStateCodes=PT,SI&pigClasses=S,E&beginDate=22/01/2019&endDate=22/04/2020 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

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

[].endDate

String

The valid end date period of the pigmeat price.

[].weekNumber

Number

The week number of the year.

[].pigClass

String

The class of the pigmeat.

[].unit

String

The unit of the pigmeat.

[].price

String

The price of the pigmeat.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "23/03/2020",
  "endDate" : "30/04/2020",
  "weekNumber" : 5,
  "price" : "€18.17",
  "unit" : "100 KG",
  "pigClass" : "Average S + E"
} ]

Poultry

Times series of average poultry prices per Member State and for the European Union with data from 1991. More information can be found on the Info tab of the portal’s poultry prices app.

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional poultry product is Broiler.

years

true

The optional year(s) to search for poultry.

months

true

The optional month(s) to search for poultry.

weeks

true

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

beginDate

true

The optional date interval start to search for poultry prices.

endDate

true

The optional date interval end to search for poultry prices.

Example of a request

GET /api/poultry/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
Host: localhost:8080

Response fields

Path Type Description

[]

Array

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

[].endDate

String

The valid end date period of the poultry price.

[].weekNumber

Number

The week number of the year.

[].productName

String

The product of the poultry.

[].unit

String

The unit of the poultry.

[].price

String

The price of the poultry.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "23/03/2020",
  "endDate" : "30/04/2020",
  "weekNumber" : 5,
  "price" : "€180.17",
  "unit" : "100 KG",
  "productName" : "Broiler"
} ]

Sheep And Goat Meat

Weekly prices for heavy and light lamb per Member State and weighted averages over the Union. More information can be found on the Info tab of the portal’s sheep and goat meat prices app.
Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

productCodes

true

The optional sheep and goat product code(s) are EU_L and EU_H they must be comma-separated.

marketCodes

true

The optional sheep and goat market name(s) are EU member state code(s) and they must be comma-separated. For more details check REST API : /api/sheepAndGoat/markets

marketingYears

true

The optional marketing year(s) to search for sheep and goat.

months

true

The optional month(s) to search for sheep and goat.

weeks

true

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

beginDate

true

The optional date interval start to search for sheep and goat prices.

endDate

true

The optional date interval end to search for sheep and goat prices.

Example of a request

GET /api/sheepAndGoat/prices?memberStateCodes=PT&productCodes=EU_H&beginDate=29/12/2014&endDate=04/01/2015 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Sheep and Goat 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 sheep and goat price.

[].endDate

String

The valid end date period of the sheep and goat price.

[].weekNumber

Number

The week number of the year.

[].marketingYear

Number

The marketing year of the sheep and goat price.

[].category

String

The category of the sheep and goat.

[].marketName

String

The market name of the sheep and goat.

[].unit

String

The unit of the sheep and goat.

[].price

String

The price of the sheep and goat.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "29/12/2014",
  "endDate" : "04/01/2015",
  "weekNumber" : 1,
  "price" : "€524.00",
  "unit" : "100CARC",
  "category" : "Heavy Lamb",
  "marketName" : "PT",
  "marketingYear" : 2015
} ]

Find Sheep And Goat categories

Example of a request

GET /api/sheepAndGoat/categories HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Sheep and Goat categories

[].category

String

The category of the sheep and goat.

[].productCode

String

The code of the sheep and goat product.

Example of a response

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

[ {
  "productCode" : "EU_H",
  "category" : "Heavy Lamb"
}, {
  "productCode" : "EU_L",
  "category" : "Light Lamb"
} ]

Find Sheep And Goat markets

Example of a request

GET /api/sheepAndGoat/markets HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Sheep and Goat markets

[].marketCode

String

The code of the sheep and goat market.

Example of a response

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

[ {
  "marketCode" : "ALL"
}, {
  "marketCode" : "BE"
} ]

Milk and dairy products

Weekly prices of raw milk as well as eight representative dairy products per Member State and weighted averages over the Union. More information can be found on the info tab of the Portal’s Raw milk prices and Dairy prices apps.

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional product(s) to search for raw milk prices. For more details check REST API : /api/rawMilk/products

years

true

The optional year(s) must have the format yyyy.

months

true

The optional month(s) of a year to search for raw milk.

beginDate

true

The optional date interval start to search for raw milk prices.

endDate

true

The optional date interval end to search for raw milk prices.

Example of a request

GET /api/rawMilk/prices?products=raw%20milk,smp&memberStateCodes=BG,NL&years=2017&months=7,8 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Raw milk price values

[].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 raw milk price.

[].endDate

String

The valid end date period of the raw milk price.

[].product

String

The product name.

[].month

Number

The month number of the calendar year.

[].monthName

String

The month name of the calendar year.

[].year

Number

The calendar year of the raw milk price.

[].unit

String

The unit of the raw milk price.

[].price

String

The raw milk price.

Example of a response

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

[ {
  "memberStateCode" : "NL",
  "memberStateName" : "Netherlands",
  "beginDate" : "04/07/2017",
  "endDate" : "11/08/2017",
  "month" : 7,
  "monthName" : "Jul",
  "price" : "€133.19",
  "unit" : "100KG",
  "year" : 2017,
  "product" : "Raw milk"
} ]

Find Raw Milk products

Example of a request

GET /api/rawMilk/products HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Raw milk products

Example of a response

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

[ "Organic raw milk", "Raw Milk" ]

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional product(s) to search for dairy prices. For more details check REST API : /api/dairy/products

years

true

The optional year(s) must have the format yyyy.

weeks

true

The optional week(s) of a year to search for dairy. Week 1 is the week with the first Thursday in January.

beginDate

true

The optional date interval start to search for dairy prices.

endDate

true

The optional date interval end to search for dairy prices.

Example of a request

GET /api/dairy/prices?products=butter,smp&memberStateCodes=BG,NL&years=2017&weeks=5 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with dairy price values

[].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 dairy price.

[].endDate

String

The valid end date period of the dairy price.

[].product

String

The product name.

[].weekNumber

Number

The week number of the calendar year.

[].year

Number

The calendar year of the dairy price.

[].unit

String

The unit of the dairy price.

[].price

String

The dairy price.

Example of a response

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

[ {
  "memberStateCode" : "NL",
  "memberStateName" : "Netherlands",
  "beginDate" : "04/07/2017",
  "endDate" : "11/08/2017",
  "weekNumber" : 5,
  "price" : "€133.19",
  "unit" : "100KG",
  "year" : 2017,
  "product" : "BUTTER"
} ]

Find Dairy products

Example of a request

GET /api/dairy/products HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with dairy products

Example of a response

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

[ "SMP", "BUTTER" ]

Fruit And Vegetable

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

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.

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
Host: localhost:8080

Response fields

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.

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"
} ]

Find 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
Host: localhost:8080

Response fields

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.

Example of a response

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

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

Find 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
Host: localhost:8080

Response fields

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.

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"
} ]

Cereals

Prices of different kinds of cereals at a number of important EU markets, in different stages of the value chain (Free On Board, Departure from Silo etc.). More information can be found on the Info tab of the portal’s cereals prices app.

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/yyyy to search for cereal prices.

months

true

The optional month(s) to search for cereal.

weeks

true

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

beginDate

true

The optional date interval start to search for cereal prices.

endDate

true

The optional date interval end to search for cereal prices.

productCodes

true

The optional product code(s) to search for cereal prices.

stageCodes

true

The optional stage code(s) to search for cereal prices.

marketCodes

true

The optional market code(es) to search for cereal prices.

Example of a request

GET /api/cereal/prices?memberStateCodes=PT&productCodes=BLT,ORG&stageCodes=DEPPORT&marketCodes=LIS&beginDate=01/02/2016&endDate=05/02/2017 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

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

[].endDate

String

The valid end date period of the cereal price.

[].weekNumber

Number

The week number of the year.

[].productName

String

The product of the cereal.

[].stageName

String

The stage of the cereal.

[].marketName

String

The market of the cereal.

[].unit

String

The unit of the cereal.

[].price

String

The price of the cereal.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "01/02/2016",
  "endDate" : "07/02/2016",
  "weekNumber" : 10,
  "price" : "151.00",
  "unit" : "TONNES",
  "productName" : "Maize",
  "marketName" : "Brussel - Bruxelles",
  "stageName" : "Departure from farm or from production area - on truck or other transport means"
} ]

List all Cereal products

Example of a request

GET /api/cereal/products HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Cereal products

[].productName

String

The name of the product.

[].productCode

String

The product code of the cereal.

Example of a response

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

[ {
  "productName" : "Maize",
  "productCode" : "MAI"
}, {
  "productName" : "Durum wheat",
  "productCode" : "DUR"
} ]

List all Cereal stages

Example of a request

GET /api/cereal/stages HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Cereal stages

[].stageName

String

The stage name.

[].stageCode

String

The stage code of the cereal.

Example of a response

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

[ {
  "stageName" : "Price at farm gate",
  "stageCode" : "FGATE"
}, {
  "stageName" : "Free On Board - Incoterm",
  "stageCode" : "FOB"
} ]

List all Cereal markets

Example of a request

GET /api/cereal/markets HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with Cereal markets

[].marketName

String

The market name.

[].marketCode

String

The market code of the cereal.

Example of a response

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

[ {
  "marketName" : "Lisboa",
  "marketCode" : "LIS"
}, {
  "marketName" : "Ljubljana",
  "marketCode" : "LJUB"
} ]

Rice

Weekly prices for different varieties of rice at different stages of the value chain in 7 producing Member States. More information can be found on the Info tab of the portal’s rice prices app.

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional code(s) of the EU Member States. For more details check REST API : /api/rice/memberStates

stages

true

The optional stage(s) to search for rice prices. For more details check REST API : /api/rice/stages

types

true

The optional rice type(s) to search for rice prices. For more details check REST API : /api/rice/types

varieties

true

The optional variety(ies) to search for rice prices. For more details check REST API : /api/rice/varieties

marketingYears

true

The optional marketing year(s) must have the format yyyy/yyyy.

weeks

true

The optional week(s) of a year to search for poultry. Week 1 is the week with the first Thursday in September.

beginDate

true

The optional date interval start to search for rice prices.

endDate

true

The optional date interval end to search for rice prices.

Example of a request

GET /api/rice/prices?stages=Broken&types=Japonica&memberStateCodes=BG,FR&varieties=Average&marketingYears=2010/2011&weeks=5 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with rice price values

[].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 rice price.

[].endDate

String

The valid end date period of the rice price.

[].stage

String

The stage from the returned rice price.

[].type

String

The type from the returned rice price.

[].variety

String

The variety from the returned rice price.

[].weekNumber

Number

The week number of the marketing year.

[].marketingYear

String

The marketing year of the rice value.

[].unit

String

The unit of the rice.

[].price

String

The price of the rice.

Example of a response

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

[ {
  "memberStateCode" : "NL",
  "memberStateName" : "Netherlands",
  "beginDate" : "04/10/2010",
  "endDate" : "11/10/2010",
  "weekNumber" : 5,
  "price" : "€133.19",
  "unit" : "Tonne",
  "marketingYear" : "2010-11",
  "stage" : "Broken",
  "type" : "Japonica",
  "variety" : "Average"
} ]

Find rice stages

Example of a request

GET /api/rice/stages HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with rice stages

Example of a response

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

[ "Broken", "Paddy" ]

Find rice types

Example of a request

GET /api/rice/types HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with rice types

Example of a response

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

[ "Japonica", "Indica" ]

Find rice varieties

Example of a request

GET /api/rice/varieties HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with rice varieties

Example of a response

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

[ "Ariete", "Rond" ]

Find Rice Member States

Example of a request

GET /api/rice/memberStates HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with rice Member States

[].code

String

The member state code.

[].name

String

The member state name.

Example of a response

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

[ {
  "name" : "Italy",
  "code" : "IT"
}, {
  "name" : "Spain",
  "code" : "ES"
} ]

Oilseeds

Weekly oilseeds prices per Member State as well as weighted averages over the Union. More information can be found on the portal’s Oilseeds prices app.

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 oilseeds prices.

products

true

The optional product(s) of an oilseed.

productTypes

true

The optional product type(s) of an oilseed.

markets

true

The optional market(s) to search for an oilseed.

marketStages

true

The optional market stage(s) to search for an oilseed.

weeks

true

The optional week(s) to search for oilseed prices.

beginDate

true

The optional date interval start to search for oilseed prices.

endDate

true

The optional date interval end to search for oilseed prices.

Example of a request

GET /api/oilseeds/prices?memberStateCodes=BG&beginDate=01/08/2021&endDate=09/08/2021&productTypes=standard&products=Crude%20sunflower%20oil&marketStages=DEPPROC HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json
 Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with oilseeds 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 oilseed price.

[].endDate

String

The valid end date period of the oilseed price.

[].weekNumber

Number

The week number of the year.

[].marketingYear

String

The marketing year of the oilseed price.

[].product

String

The product name of the oilseed.

[].productType

String

The product type name of the oilseed.

[].market

String

The market name of the oilseed.

[].marketStage

String

The market stage name of the oilseed.

[].unit

String

The unit of the oilseed.

[].price

String

The price of the oilseed.

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 346
 
 [ {
   "memberStateCode" : "BG",
   "memberStateName" : "Bulgaria",
   "beginDate" : "02/08/2021",
   "endDate" : "08/08/2021",
   "weekNumber" : 6,
   "price" : "€1518.56",
   "unit" : "Tonne",
   "product" : "Crude sunflower oil",
   "productType" : "Standard",
   "marketStage" : "DEPPROC",
   "market" : "National",
   "marketingYear" : "2021/2022"
 } ]

Find Oilseeds Products

Example of a request

GET /api/oilseeds/products HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json
 Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with oilseeds products

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 43
 
 [ "Sunflower seed", "Sunflower seed meal" ]

Find Oilseeds Product Types

Example of a request

GET /api/oilseeds/productTypes HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json
 Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with oilseeds product types

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 54
 
 [ "30-35% protein content", "40-50% protein content" ]

Find Oilseeds Markets

Example of a request

GET /api/oilseeds/markets HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json
 Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with oilseeds markets

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 24
 
 [ "National", "Zagreb" ]

Find Oilseeds Market Stages

Example of a request

GET /api/oilseeds/marketStages HTTP/1.1
 Content-Type: application/json;charset=UTF-8
 Accept: application/json
 Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with oilseeds market stages

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 22
 
 [ "DEPPROC", "FGATE" ]

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

Request parameters

Parameter Optional Description

regions

true

The optional sugar regions of the EU.

yms

true

The optional marketing Year(s)-Month(s) of a sugar price.

marketingYears

true

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

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
 Host: localhost:8080

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.

[].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
 Content-Length: 179
 
 [ {
   "sugarRegion" : "Region EU Average",
   "price" : "€308.56",
   "unit" : "Tonne",
   "ym" : "2020-10",
   "marketingYear" : "2020/2021",
   "marketingYearMonth" : "October"
 } ]

Find sugar regions

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with sugar regions

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 52
 
 [ "Region 1", "Region 2", "Region 3", "EU Average" ]

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.

More information can be found on the portal’s Olive oil prices app.

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.

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
 Host: localhost:8080

Response fields

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.

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 313
 
 [ {
   "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"
 } ]

Find olive oil products

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with olive oil products

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 60
 
 [ "Lampante olive oil (2%)", "Virgin olive oil (up to 2%)" ]

Find olive oil markets

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with olive oil markets

Example of a response

HTTP/1.1 200 OK
 Content-Type: application/json
 Content-Length: 55
 
 [ "Alentejo Sul", "Alentejo Norte", "Palermo (ITG12)" ]

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.

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
Host: localhost:8080

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"
} ]

List all Wine descriptions

Example of a request

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

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"
} ]

Weekly TAXUD imports and exports

Weekly import statistics of agricultural products based on the "Surveillance" System of the Taxation and Customs Union DG, as shown in the imports and exports reports presented on the portal.

The United Kingdom is no longer a Member State of the European Union, however until the end of the transition period it was still part of the EU Customs Union. Taxud EU trade data therefore also included the UK as long as it was part of the Customs Union. Such data is labelled as EU+UK.

Find Taxud Import weekly data

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional product(s) must be comma-separated. For more details check REST API : /api/taxud/weeklyData/import/products

importCategories

true

The optional import categor(ies) must be comma-separated. For more details check REST API : /api/taxud/weeklyData/importCategories

marketingYears

true

The optional marketing year(s) must have the format yyyy or yyyy/yyyy.

months

true

The optional month(s) to search for data.

marketingWeeks

true

The optional week(s) of a year to search for weekly data. The first week of January is number 1.

sectors

true

The optional sectors to search for data. For more details check REST API : /api/taxud/weeklyData/sectors

cn8ProductCodes

true

The optional CN 8 length product code(s). For more details check REST API : /api/taxud/weeklyData/import/cn8ProductCodes

taric10ProductCodes

true

The optional CN 10 length product code(s). For more details check REST API : /api/taxud/weeklyData/import/taric10ProductCodes

partnerCodes

true

The optional partner country code(s).

Example of a request

GET /api/taxud/weeklyData/import?importCategories=Import%20-%20preferential&memberStateCodes=PT&partnerCodes=BR&products=Offals&sectors=Beef&taric10ProductCodes=0215786354&cn8ProductCodes=02157863 HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with weekly data values

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].sector

String

The sector of weekly data.

[].marketingWeek

Number

The marketing week of the year.

[].marketingYear

String

The marketing year of the weekly data values.

[].partnerCode

String

The partner country code.

[].partner

String

The partner country name.

[].product

String

The product of the weekly data values.

[].procedure

Number

The procedure of the weekly data values.

[].cn8ProductCode

String

The cn 8 digit code of the weekly data values.

[].taric10ProductCode

String

The cn 10 digit code of the weekly data values.

[].preference

Number

The preference of the weekly data values.

[].euroValue

Number

The euro value price of the weekly data values.

[].unitValue

Number

The unit value.

[].kg

Number

The amount in Kg.

[].kgEquivalent

Number

The amount of equivalent Kg equivalent which depends on a coefficient.

[].coefficient

Number

The coefficient used to calculate the Kg equivalent by multiplying with the Kg.

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 477
   
   [ {
     "sector" : "Beef",
     "marketingYear" : "2020",
     "marketingWeek" : 2,
     "memberStateCode" : "NL",
     "memberStateName" : "Netherlands",
     "partnerCode" : "BR",
     "partner" : "US",
     "product" : "United States of America",
     "cn8ProductCode" : "02061095",
     "taric10ProductCode" : "0206109515",
     "procedure" : 40,
     "preference" : 125,
     "euroValue" : 3158,
     "unitValue" : 14.64,
     "kg" : 216,
     "kgEquivalent" : 216,
     "coefficient" : 0.0
   } ]

Find Taxud Sectors

Example of a request

GET /api/taxud/weeklyData/sectors HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/sectors' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance sectors

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 29
   
   [ "Beef", "Garlic", "Honey" ]

Find Taxud Import Categories

Example of a request

GET /api/taxud/weeklyData/importCategories HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/importCategories' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance Import Categories

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 90
   
   [ "Import - most favoured nation", "Import - preferential", "Import - tariff rate quota" ]

Find Taxud Import CN 8 digit Product Codes

Example of a request

GET /api/taxud/weeklyData/import/cn8ProductCodes HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/import/cn8ProductCodes' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance import CN 8 digit product codes

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 26
   
   [ "07129090", "07108095" ]

Find Taxud Import Taric Product Codes

Example of a request

GET /api/taxud/weeklyData/import/taric10ProductCodes HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/import/taric10ProductCodes' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance import Taric 10 digit product codes

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 30
   
   [ "0712909010", "0710809560" ]

Find Taxud Import Products

Example of a request

GET /api/taxud/weeklyData/import/products HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/import/products' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance import products

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 49
   
   [ "Eggs in shell", "Fresh meat - other poultry" ]

Find Taxud Export weekly data

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional product(s) must be comma-separated. For more details check REST API : /api/taxud/weeklyData/export/products

marketingYears

true

The optional marketing year(s) must have the format yyyy or yyyy/yyyy.

months

true

The optional month(s) to search for data.

marketingWeeks

true

The optional week(s) of a year to search for weekly data. The first week of January is number 1.

sectors

true

The optional sectors to search for data. For more details check REST API : /api/taxud/weeklyData/sectors

cn8ProductCodes

true

The optional CN 8 length product code(s). For more details check REST API : /api/taxud/weeklyData/import/cn8ProductCodes

taric10ProductCodes

true

The optional CN 10 length product code(s). For more details check REST API : /api/taxud/weeklyData/import/taric10ProductCodes

partnerCodes

true

The optional partner country code(s).

Example of a request

GET /api/taxud/weeklyData/export?memberStateCodes=NL&partnerCodes=AR&products=Offals&sectors=Beef&taric10ProductCodes=0215786354&cn8ProductCodes=02157863 HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with weekly data values

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].sector

String

The sector of weekly data.

[].marketingWeek

Number

The marketing week of the year.

[].marketingYear

String

The marketing year of the weekly data values.

[].partnerCode

String

The partner country code.

[].partner

String

The partner country name.

[].product

String

The product of the weekly data values.

[].procedure

Number

The procedure of the weekly data values.

[].cn8ProductCode

String

The cn 8 digit code of the weekly data values.

[].taric10ProductCode

String

The cn 10 digit code of the weekly data values.

[].preference

Number

The preference of the weekly data values.

[].euroValue

Number

The euro value price of the weekly data values.

[].unitValue

Number

The unit value.

[].kg

Number

The amount in Kg.

[].kgEquivalent

Number

The amount of equivalent Kg equivalent which depends on a coefficient.

[].coefficient

Number

The coefficient used to calculate the Kg equivalent by multiplying with the Kg.

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 481
   
   [ {
     "sector" : "Beef",
     "marketingYear" : "2020",
     "marketingWeek" : 2,
     "memberStateCode" : "NL",
     "memberStateName" : "Netherlands",
     "partnerCode" : "US",
     "partner" : "United States of America",
     "product" : "Offals",
     "cn8ProductCode" : "02061095",
     "taric10ProductCode" : "0206109515",
     "procedure" : 40,
     "preference" : 125,
     "euroValue" : 3158,
     "unitValue" : 14.64,
     "kg" : 216,
     "kgEquivalent" : 216,
     "coefficient" : 0.0
   } ]

Find Taxud Export CN 8 digit Product Codes

Example of a request

GET /api/taxud/weeklyData/export/cn8ProductCodes HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/export/cn8ProductCodes' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance export CN 8 digit product codes

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 26
   
   [ "04021019", "10041000" ]

Find Taxud Export Taric Product Codes

Example of a request

GET /api/taxud/weeklyData/export/taric10ProductCodes HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/export/taric10ProductCodes' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance export Taric 10 digit product codes

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 30
   
   [ "0805400039", "2204219190" ]

Find Taxud Export Products

Example of a request

GET /api/taxud/weeklyData/export/products HTTP/1.1
   Content-Type: application/json;charset=UTF-8
   Accept: application/json
   Host: localhost:8080
$ curl 'http://localhost:8080/api/taxud/weeklyData/export/products' -i -X GET \
       -H 'Content-Type: application/json;charset=UTF-8' \
       -H 'Accept: application/json'

Response fields

Path Type Description

[]

Array

Array with Taxud surveillance export products

Example of a response

HTTP/1.1 200 OK
   Content-Type: application/json
   Content-Length: 23
   
   [ "Offals", "Oranges" ]

CMEF Indicator data

The Common Monitoring and Evaluation Framework (CMEF) for the CAP 2014-2020 identifies a set of performance indicators in four categories: context, output, result and impact. Context indicators provide information on agricultural and rural statistics as well as general economic and environmental trends.

More information can be found on the portal’s CMEF indicators page.

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

years

true

The optional year(s) must be in format yyyy to search for CMEF indicator values.

types

true

The optional type(s) of a CMEF indicator.

categories

true

The optional category(ies) of a CMEF indicator.

indicators

true

The optional name(s) of the indicator(s) to search for.

subindicators

true

The optional name(s) of the subindicator(s) to search for a CMEF indicator values.

parameters

true

The optional parameter(s) to search for a CMEF indicator values.

units

true

The optional unit(s) to search for a CMEF indicator values.

codes

true

The optional code(s) to search for a CMEF indicator values.

sources

true

The optional source(s) system to search for a CMEF indicator values.

Example of a request

GET /api/cmefIndicators/values?memberStateCodes=PT&sources=eurostat&codes=CTX_SOC_01_2b&years=2018 HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with CMEF indicators values

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].indicator

String

The CMEF indicator.

[].subindicator

String

The CMEF subindicator.

[].parameter

String

The parameter of the CMEF indicator value.

[].unit

String

The unit of the CMEF indicator value.

[].flag

String

Based on Eurostat flags, will allow noting, for instance, if the data is provisional. The list of valid flags is : b = break in time series;
c = confidential;
d = definition differs;
e = estimated value;
f = forecast;
n = not significant;
p = provisional value;
r = Revised;
s = Eurostat estimate;
u = low reliability;
z = not applicable;
V = EU evolutive;
L = LFA definition (and not ANC);
H = EU without Croatia;
I = Inconsistent data notified by MS;
T = 3 year average;
F = year N corresponds to Financial Year N+1;
C = Cumulative data;

[].code

String

The code of the CMEF indicator value.

[].source

String

The source system of the CMEF indicator value.

[].year

Number

The year of the CMEF indicator value.

[].value

Number

The value of the CMEF indicator.

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 340
  
  [ {
	"indicator" : "C.01 Population",
	"subindicator" : "Distribution of population by type of region",
	"parameter" : "intermediate regions",
	"unit" : "% of total",
	"code" : "CTX_SOC_01_2b",
	"source" : "EUROSTAT",
	"memberStateCode" : "PT",
	"memberStateName" : "Portugal",
	"year" : 2014,
	"value" : 39.08,
	"flag" : "H"
  } ]

Find Cmef Indicators types

Example of a request

GET /api/cmefIndicators/types HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with CMEF indicators types

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 23
  
  [ "Context", "Impact" ]

Find Cmef Indicators categories

Example of a request

GET /api/cmefIndicators/categories HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with all categories

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 27
  
  [ "Environment", "Impact" ]

Find Cmef Indicators indicators

Example of a request

GET /api/cmefIndicators/indicators HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with CMEF indicators

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 43
  
  [ "C.01 Population", "C.02 Age structure" ]

Find Cmef Indicators Subindicators

Request parameters

Parameter Optional Description

indicators

true

The optional name(s) of the indicator(s) to search for subindicator(s).

Example of a request

GET /api/cmefIndicators/subindicators?indicators=C.01%20Population HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with CMEF subindicators

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 70
  
  [ "Distribution of population by type of region", "Total population" ]

Find Cmef Indicators parameters

Request parameters

Parameter Optional Description

indicators

true

The optional name(s) of the indicator(s) to search for parameter(s).

subindicators

true

The optional name(s) of the subindicator(s) of the CMEF indicator to search for parameter(s)

Example of a request

GET /api/cmefIndicators/parameters?indicators=C.01%20Population&subindicators=Distribution%20of%20population%20by%20type%20of%20region HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with CMEF parameters

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 43
  
  [ "intermediate regions", "rural regions" ]

Find Cmef Indicators units

Example of a request

GET /api/cmefIndicators/units HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with all units

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 18
  
  [ "%", "persons" ]

Find Cmef Indicators codes

Example of a request

GET /api/cmefIndicators/codes HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with all codes

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 36
  
  [ "CTX_ENV_31_1a", "CTX_ENV_32_2b" ]

Find Cmef Indicators sources

Example of a request

GET /api/cmefIndicators/sources HTTP/1.1
  Content-Type: application/json;charset=UTF-8
  Accept: application/json
  Host: localhost:8080

Response fields

Path Type Description

[]

Array

Array with all sources

Example of a response

HTTP/1.1 200 OK
  Content-Type: application/json
  Content-Length: 20
  
  [ "ABAC", "COMEXT" ]