User profile

A user profile is a visual display of personal data associated with a specific user. This data will only be displayed for users that purchased the “marktplaats extra”, “bedrijfs profilering” products. Or users that are admarkt customers.

Information on buying features can be found at buy-feature.

Fields

field type constraints Req W U
title string max. 150 chars, cannot contain emails or urls yes yes yes
description string max. 500 chars yes yes yes
videoUrl string max. 150 chars no yes yes
mission string max. 500 chars no yes yes
sellerUrl string max. 150 chars no yes yes
awards string max. 500 chars no yes yes

title

The profile title.

description

The profile description

videoUrl

From where to load the video

mission

The mission statement

sellerUrl

The seller url

awards

The awards

Relations

name availability embedded cardinality
mp:profile-image always no 1
mp:backdrop-image always no 1
mp:logo-image always no 1

Reference

GET /v1/users/{userId}/profile

Get a user’s profile.

PUT /v1/users/{userId}/profile

Update a user’s profile

PATCH /v1/users/{userId}/profile

Do a partial update of a user’s profile

Errors

http error code description
400 validation-failure
Validation of the profile failed.
There should be more information in the field errors

Field errors

field error code error value description
<field name> input-invalid The value for this field is invalid.
<field name> input-too-long the maximum allowed length The length of the supplied value exceeds the maximum allowed length for this field
<field name> missing-required-field A required field is missing or empty (while that is not allowed).

Examples

Retrieving a user profile :

Request :

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

Response :

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

{
 "_links":{
   "self":{
     "href":"/v1/users/1/profile"
   },
   "describedby":{
     "href":"https://api.marktplaats.nl/docs/v1/user-profile.html"
   },
   "mp:backdrop-image": {
     "href":"/v1/users/1/profile/backdrop-image"
   },
   "mp:profile-image": {
     "href":"/v1/users/1/profile/profile-image"
   },
   "mp:logo-image": {
     "href":"/v1/users/1/profile/logo-image"
   }
 },
 "_embedded": {
   "mp:backdrop-image": {
     "_links": {
       "self": {
         "href": "/v1/images/1001"
       },
       "mp:image-blob": {
         "href": "/v1/images/1001/{size}/blob",
         "templated": true
       },
       "mp:image-meta": {
         "href": "/v1/images/1001/{size}/meta",
         "templated": true
       }
     },
     "imageId": 1001,
     "status": "available",
     "small": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "medium": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "large": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_83.JPG"
     },
     "xlarge": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_84.JPG"
     }
   },
   "mp:profile-image": {
     "_links": {
       "self": {
         "href": "/v1/images/1002"
       },
       "mp:image-blob": {
         "href": "/v1/images/1002/{size}/blob",
         "templated": true
       },
       "mp:image-meta": {
         "href": "/v1/images/1002/{size}/meta",
         "templated": true
       }
     },
     "imageId": 1002,
     "status": "available",
     "small": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "medium": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "large": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_83.JPG"
     },
     "xlarge": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_84.JPG"
     }
   },
   "mp:logo-image": {
     "_links": {
       "self": {
         "href": "/v1/images/1003"
       },
       "mp:image-blob": {
         "href": "/v1/images/1003/{size}/blob",
         "templated": true
       },
       "mp:image-meta": {
         "href": "/v1/images/1003/{size}/meta",
         "templated": true
       }
     },
     "imageId": 1003,
     "status": "available",
     "small": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "medium": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_82.JPG"
     },
     "large": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_83.JPG"
     },
     "xlarge": {
       "href": "https://eps.marktplaats.dev/eps/8780296fd30d43c354ae83216f325610/$_84.JPG"
     }
   }
 },
 "title": "Super shop",
 "description": "Better than all the rest",
 "videoUrl": "some video url",
 "mission": "we make our customers proud of their purchase",
 "sellerUrl": "some seller url",
 "awards": "best shop of the Netherlands in 2017"
}