Request parameter
Value
Required or optional
Default
Endpoints
Authentication required 
media
enum
Optional
include
summary, reviews
No

media specifies how feedback with media (photographic and/or video) will be included in the JSON feed. Only valid where:

  • mode = all
  • mode = service
  • mode = product

Possible values are:

  • include
    The resulting feed will be dependent on the mode as follows:
    • mode = all
      Feedback with associated service/product media will be returned alongside feedback which does not have associated media.
    • mode = service
      Service feedback with associated service media will be returned alongside feedback which does not have associated media.
    • mode = product
      Product feedback with associated product media will be returned alongside feedback which does not have associated media.
  • exclude
    The resulting feed will be dependent on the mode as follows:
    • mode = all
      Feedback with associated service/product media will be excluded from the result set.
    • mode = service
      Service feedback with associated service media will be excluded from the result set.
    • mode = product
      Product feedback with associated product media will be excluded from the result set.
  • only
    The resulting feed will be dependent on the mode as follows:
    • mode = all
      Only feedback with associated service/product media will be returned.
    • mode = service
      Only service feedback with associated service media will be returned.
    • mode = product
      Only product feedback with associated product media will be returned.
  • video
    The resulting feed will be dependent on the mode as follows:
    • mode = all
      Only feedbacks with associated service/product video media will be returned.
    • mode = service
      Only service feedback with associated service video media will be returned.
    • mode = product
      Only product feedback with associated product video media will be returned.
  • photo
    The resulting feed will be dependent on the mode as follows:
    • mode = all
      Only feedbacks with associated service/product photo media will be returned.
    • mode = service
      Only service feedback with associated service photo media will be returned.
    • mode = product
      Only product feedback with associated product photo media will be returned.


An example Reviews API call using 
media is:

https://api.feefo.com/api/version/reviews/all?merchant_identifier=example-retail-merchant&media=video

Where:

  • version = the version of the API associated with the URL. See API Versions for the version number.
  • all = returns both service and product reviews.
  • merchant_identifier = the merchant's unique Feefo identifier, which in this example is example-retail-merchant.
  • media = determines if feedback with associated media will be included. In this example, service/product reviews with video content will be passed to the feed.

If a consumer flags a photo or video as needing moderation, Feefo will review the content and if it's felt unsuitable, it will be deleted from public view. Any media file that's been deleted will still be listed in the feed when using the media parameter but all of the URLs for that file will point to a replacement image that says Feefo has removed it. Any deleted photo or video will also be marked within the feed data as "removed":true as in this example:

"media":[{"id":"5940f50d498e9730b0XXXXXX",
"type":"PHOTO","url":"URL to image","caption":"thumb-1920-158996",
"social":{"facebook":"Facebook share URL","twitter":"Twitter share URL","google_plus":"Google+ share URL"},
"removed":true,
"helpful_votes":0}],

Full details about the API can be found at Reviews API (Customisable Integration).

Reviews API Parameter: childrenReviews API Parameter: empty_product_comments