User reviews

The user reviews entity returns user reviews. This includes reviews in our own system, or external providers. The type of review is indicated with the review. Reviews of external parties like Tevreden.nl and Klantenvertellen.nl are only shown when the user has bought the feature Klantscore . Information on buying features can be found at buy-feature.

Fields

field type constraints Req W U
numberOfReviews number (integer)
no no no
averageScore number (float)
no no no
averageSubScores array(object)
no no no
averageSubScores.description string
no no no
averageSubScores.score number (float)
no no no

numberOfReviews

The number of reviews for this user.

averageScore

The average score of the reviews.

averageSubScores

The subscores for the various parts on which a user can get individual scores.

averageSubScores.description

The description of the subscore

averageSubScores.score

The score of an individual item on which the user get rated

Reference

GET /v1/users/{userId}/reviews

Get user reviews

Examples

Retrieving the reviews for a user:

Request:

GET /v1/users/1/reviews HTTP/1.1
Host: api.marktplaats.nl

Response

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

   {
       "_links": {
       "self": {
           "href":"/v1/users/1/reviews"
       },
       "describedby": {
           "href":"https://api.marktplaats.nl/docs/v1/user-reviews.html"
       },
   },
   "_embedded": {
       "mp:user-review":[
           {
               "platform":"klantenvertellen",
               "name":"Vrouw",
               "place":"Bilthoven",
               "date":"2014-0-12",
               "reason":"Evaluatie aanschaf gebruikte auto/occasion",
               "overallScore": 8,
               "content":"De autoverkoper was erg behulpzaam"
               "subScores":[
                   {
                       "description":"klantgerichtheid",
                       "score": 8.2
                   },
                   {
                       "description":"nazorg",
                       "score":9.1
                   }
               ]
           }
       ]
   }
   "numberOfReviews": 10
   "averageScore": 5.8
   "averageSubScores": [
       {
           "description":"klantgerichtheid",
           "score": 8.2
       },
       {
           "description":"nazorg",
           "score": 9.1
       }
   ]

}

Retrieving the settings for reviews :

Request :

GET /v1/users/1/reviews-settings HTTP/1.1
Host: api.marktplaats.nl

Response :

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

{
 "_links": {
   "self": {
     "href":"/v1/users/1/reviews-settings"
   },
   "describedby": {
     "href":"https://api.marktplaats.nl/docs/v1/user-reviews-settings.html"
   },
 },
 "reviewsPlatform": "tevreden",
 "reviewsUser": "handyHarry"
}