Eggs and Poultry

Times series of average poultry prices per Member State and for the European Union with data from 1991. Monthly volumes in case of poultry production. More information can be found on the Info tab of the portal’s poultry prices app, egg prices app and poultry production app.
SUB-SECTIONS:
Poultry prices Poultry price types
Poultry monthly prices Poultry monthly price types
Egg prices Eggs farming methods
Poultry production Poultry production animals

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional poultry product name(s) must be Broiler, Breast and Legs.

priceTypes

true

The optional poultry price type(s) must be 'Selling price' (default if nothing specified), 'Retail buying prices', 'Non-retail buying prices' or 'All'.

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

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.

[].priceType

String

The price type 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: 254

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

Poultry price types

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with all poultry price types

Example of a response

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

[ "Non-retail buying prices", "Retail buying prices", "Selling price" ]

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

products

true

The optional poultry product name(s) must be Broiler and Breast.

priceTypes

true

The optional poultry price type(s) to search for poultry monthly prices.

years

true

The optional year(s) to search for poultry monthly prices.

months

true

The optional month(s) to search for poultry monthly prices.

beginDate

true

The optional date interval start to search for poultry monthly prices.

endDate

true

The optional date interval end to search for poultry monthly prices.

Example of a request

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

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 monthly price.

[].endDate

String

The valid end date period of the poultry monthly price.

[].marketingYear

Number

The marketing year of the poultry monthly price.

[].monthNumber

Number

The month number of the poultry monthly price.

[].month

Number

The month of the poultry monthly price.

[].productName

String

The product of the poultry monthly price.

[].priceType

String

The price type of the poultry monthly price.

[].unit

String

The unit of the poultry monthly price.

[].price

String

The price of the poultry monthly price.

Example of a response

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

[ {
  "memberStateCode" : "PT",
  "memberStateName" : "Portugal",
  "beginDate" : "01/04/2020",
  "endDate" : "30/04/2020",
  "price" : "€138.03 ",
  "unit" : "national currency/100kg",
  "marketingYear" : 2020,
  "monthNumber" : 4,
  "month" : "April",
  "productName" : "Whole broiler (65%)",
  "priceType" : "Selling price"
} ]

Poultry monthly price types

Example of a request

GET /api/poultry/prices/month/priceTypes HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

[]

Array

Array with all poultry monthly price types

Example of a response

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

[ "Non-retail buying prices", "Retail buying prices", "Selling price" ]

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States.

farmingMethods

true

The optional egg(s) farming method(s). For more details check the REST API : /api/poultry/egg/farmingMethods

marketingYears

true

The optional marketing year(s) to search for egg price.

weekNumbers

true

The optional week number(s) to search for egg price.

months

true

The optional month(s) to search for egg.

beginDate

true

The optional date interval start to search for egg price.

endDate

true

The optional date interval end to search for egg price.

Example of a request

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

Response fields

Path Type Description

[]

Array

Array with egg(s) 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 egg price.

[].endDate

String

The valid end date period of the egg price.

[].marketingYear

Number

The marketing year corresponding to the egg price.

[].weekNumber

Number

The week number corresponding to the egg price.

[].farmingMethod

String

The farming method of the egg.

[].unit

String

The unit of the egg.

[].price

String

The price of the egg.

Example of a response

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

[ {
  "beginDate" : "04/10/2021",
  "endDate" : "11/10/2021",
  "price" : "€168.03",
  "unit" : "€/100Kg",
  "farmingMethod" : "Barn",
  "marketingYear" : 2021,
  "weekNumber" : 40,
  "memberStateCode" : "DK",
  "memberStateName" : "Denmark"
} ]

Eggs farming methods

Example of a request

GET /api/poultry/egg/farmingMethods HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json

Response fields

Path Type Description

[]

Array

Array with all eggs farming methods

Example of a response

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

[ "Barn", "Cage", "Free range", "Organic" ]

Request parameters

Parameter Optional Description

memberStateCodes

true

The optional codes of the EU Member States to search for poultry production.

animals

true

The optional poultry animals to search for poultry production. Multiple animals must be comma-separated. For more details check the REST API : /api/poultry/production/animals

years

true

The optional year(s) to search for poultry production.

months

true

The optional month(s) number to search for poultry production.

Example of a request

GET /api/poultry/production?memberStateCodes=AT&years=2021 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 production

[].memberStateCode

String

The code of the EU Member State.

[].memberStateName

String

The name of the EU Member State.

[].animal

String

The animal of the poultry production.

[].year

Number

The year corresponding to the poultry production volume.

[].month

String

The month of the year.

[].tonnes

Number

The number of production volume in 1000 Tonnes.

[].heads

Number

The number of production volume in 1000 Heads.

[].kgPerHead

Number

The number of production volume in Kg/head.

Example of a response

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

[ {
  "memberStateCode" : "AT",
  "memberStateName" : "Austria",
  "year" : 2021,
  "month" : "December",
  "animal" : "Chicken",
  "tonnes" : 11.51,
  "heads" : 9022.5,
  "kgPerHead" : 1.28
} ]

Poultry production animals

Example of a request

GET /api/poultry/production/animals 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 production animals

Example of a response

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

[ "Boiling hen", "Broiler", "Chicken", "Duck", "Goose", "Guinea fowl", "Other poultry", "Poultry meat", "Turkey" ]