Introduction

The Product Ratings API returns a list of all of the merchant's products with their average ratings calculated over a defined period, the default being the last five years' worth of data.

📘
Note
See parameters for explanations

Example 1

<https://api.feefo.com/api/version/products/ratings?merchant_identifier=example-retail-merchant>

This example returns data similar to the following format:

{
  "products": [
    {"rating": 3.5, "vendor_ref": "SKU187098864792156"},
    {"rating": 4.2, "vendor_ref": "SKU1870981878808479"},
    {"rating": 4.5, "vendor_ref": "ERPKIPEAPTG6M9H9Y1WZ"}
  ]
}

Example 2

<https://api.feefo.com/api/version/products/ratings?merchant_identifier=example-retail-merchant&since_period=month&review_count=true>

This returns data similar to:

{
  "products": [
    {"rating": 3.0, "sku": "SKU187098864792156", "review_count": 1},
    {"rating": 4.1, "sku": "SKU1870981878808479", "review_count": 5},
    {"rating": 4.8, "sku": "ERPKIPEAPTG6M9H9Y1WZ", "review_count": 7}
  ]
}

Locales we support:

Language	locales
Bulgarian	bg_BG
Catalan (Spain)	ca_ES
Czech	cs_CS
Danish	da_DK
German	de_DE
Greek	el_GR
English (UK)	en_GB
English (US)	en_US
Spanish	es_ES
Finnish	fi_FI
French (Canada)	fr_CA
French (France)	fr_FR
Croatian	hr_HR
Hungarian	hu_HU
Indonesian	in_ID
Italian	it_IT
Japanese	ja_JP
Korean	ko_KP
Lithuanian	lt_LT
Latvian	lv_LV
Dutch	nl_NL
Norwegian	no_NO
Polish	pl_PL
Portuguese (Brazil)	pt_BR
Portuguese (Portugal)	pt_PT
Romanian	ro_RO
Russian	ru_RU
Slovak	sk_SK
Swedish	sv_SV
Thai	th_TH
Turkish	tr_TR
Chinese (China)	zh_CN
Chinese (Hong Kong)	zh_HK
Welsh	cy_GB