Attributes
This endpoint can be used to retrieve a list of available attributes within a category
Important notice
From February 1st, 2025 the following attributes will be made mandatory by Marktplaats for DSA (Digital Services Act) authorized business sellers, due to European legislation:
(General Product Safety Regulation (GPSR - EU 2023/988) section 2, art. 19)
- manufacturerTradename
- manufacturerAddress
- manufacturerEmail
This is regarding all new advertisments as well as existing advertisments beïng updated.
In contradiction to what was communicated earlier by Marktplaats, this includes all advertisments regardless whether a user is a DSA Approved Business Seller with payment transactions enabled or not.
You can use the newly introduced parameter userId when using endpoint /attributes/ to determin whether or not the attribute is mandatory for the specified user.
In order to assist our clients with this transition, we also introduced a new endpoint to our API: /manufacturers/
This endpoint will allow a client to generate a predefined list of manufacturers which can be used to complete the payload of the /ads/ endpoint in your own application.
This functionality is also available in our webinterface
Reference
POST /attributes/
Retrieve a list of the available attributes within a category and optionally filter the result using additional parameters.
General search parameters
| field | type | description/constraints | Req | W | U |
|---|---|---|---|---|---|
| useCache | boolean | Use API caching module | No | No | No |
| categoryId | array | List of categoryId’s to include in the search result. When omitted: all categories linked with this client will be in the result. |
Yes | No | No |
| locale | array | List of locales to include in the search-result | No | No | No |
| userId | int | Use the userId's accesstoken for connected portals to retrieve realtime, user specific info. | No | No | No |
| When the user is not connected to a portal, no results will be returned for that portal. | |||||
| There might be a performance penalty when using this parameter. |
Fields
| field | type | constraints | W | U |
|---|---|---|---|---|
| categoryId | int | The categoryId | No | No |
| attributes | array | List of attributeCollection-objects per portal / locale | No | No |
Fields attributeCollection
| field | type | constraints | W | U |
|---|---|---|---|---|
| portal | string | The portal | No | No |
| locale | string | The locale. Default: nl_NL | No | No |
| attributes | array | List of attribute-objects | No | No |
Fields attribute
| field | type | constraints | W | U |
|---|---|---|---|---|
| key | string | The identifier for this attribute | No | No |
| label | string | Description-field to use in an interface to describe what this attribute is all about. | No | No |
| values | array | List of available options | No | No |
| type | string | Available options:
|
No | No |
| sort | int | No | No | |
| minimum | int | The minimum value to submit | No | No |
| maximum | int | The maximum value to submit | No | No |
| unit | string | The unit (kg. / km/h etc…) | No | No |
| mandatory | boolean | The attribute is mandatory | No | No |
| writable | boolean | No | No | |
| updatable | boolean | No | No | |
| searchable | boolean | No | No |
Example
Request
POST /rest/v1/attributes/ HTTP/2
{
"useCache": false,
"groupId": [
1
],
"categoryId": [
4,
859
],
"locale": [
"nl_NL"
],
"conversiontree": true,
"page": 1,
"itemsPerPage": 100
}
Response
{
"result": true,
"fromCache": false,
"speed": 0.029797077178955079,
"data": [
{
"categoryId": 4,
"attributes": [
{
"portal": "marktplaats",
"locale": "nl_NL",
"attributes": [
{
"key": "delivery",
"label": "Levering",
"type": "STRING",
"values": [
"Ophalen of Verzenden",
"Ophalen",
"Verzenden"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
}
]
}
]
},
{
"categoryId": 859,
"attributes": [
{
"portal": "marktplaats",
"locale": "nl_NL",
"attributes": [
{
"key": "situated",
"label": "Ligging",
"type": "STRING",
"values": [
"Dorp",
"Stad",
"Landelijk",
"Recreatiepark",
"Overige"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "surroundings",
"label": "Omgeving",
"type": "LIST",
"values": [
"Aan zee",
"Aan meer of rivier",
"In bergen of heuvels",
"In bos",
"In wintersportgebied"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "extras",
"label": "Extra's",
"type": "LIST",
"values": [
"Afwasmachine",
"Airconditioning",
"Huisdier toegestaan",
"Internet",
"Jacuzzi",
"Kinderbed",
"Open haard",
"Rolstoelvriendelijk",
"Sauna",
"Speeltuin",
"Tuin",
"Tv",
"Wasmachine",
"Zwembad"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
}
]
},
{
"portal": "goedgeplaatst",
"locale": "nl_NL",
"attributes": [
{
"key": "Naam",
"label": "Naam",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Contactpersoon",
"label": "Contactpersoon",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Adres",
"label": "Adres",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Huisnummer",
"label": "Huisnummer",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Postcode",
"label": "Postcode",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Plaats",
"label": "Plaats",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Telefoon",
"label": "Telefoon",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Land",
"label": "Land",
"type": "STRING",
"values": [
"België",
"Duitsland",
"Frankrijk",
"Groot-Brittannië",
"Italië",
"Luxemburg",
"Nederland",
"Oostenrijk",
"Slovenië",
"Spanje"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "E-mail",
"label": "E-mail",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Oppervlakte",
"label": "Oppervlakte",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "m2",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Aantal plaatsen",
"label": "Aantal plaatsen",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Electra (CCE)",
"label": "Electra (CCE)",
"type": "STRING",
"values": [
"Ja",
"Nee"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Staanplaatsen",
"label": "Staanplaatsen",
"type": "LIST",
"values": [
"Schaduw",
"Zon"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Recreatie",
"label": "Recreatie",
"type": "LIST",
"values": [
"Sportterrein"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Sanitair",
"label": "Sanitair",
"type": "LIST",
"values": [
"Babyruimte",
"Chemisch toilet",
"Verwarmd sanitair"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Omschrijving",
"label": "Omschrijving",
"type": "LIST",
"values": [
"Droger",
"Kinderbad",
"Recreatieruimte",
"Restaurant",
"Snackbar",
"Winkel"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Verhuur",
"label": "Verhuur",
"type": "LIST",
"values": [
"Appartementen",
"Bungalows",
"Fietsen",
"Stacaravans",
"Tenten",
"Vakantiehuisjes"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Betaalmiddelen",
"label": "Betaalmiddelen",
"type": "LIST",
"values": [
"Contant",
"Master Card",
"Pinnen",
"Visa Card"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Provincie",
"label": "Provincie",
"type": "STRING",
"values": [
"Drenthe",
"Flevoland",
"Friesland",
"Gelderland",
"Groningen",
"Limburg",
"Noord-Brabant",
"Noord-Holland",
"Overijssel",
"Utrecht",
"Zeeland",
"Zuid-Holland"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "Land",
"label": "Land",
"type": "TEXT",
"values": "",
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
}
]
}
]
},
{
"categoryId": 4,
"attributes": [
{
"portal": "tweedehands",
"locale": "nl_NL",
"attributes": [
{
"key": "delivery",
"label": "Levering",
"type": "STRING",
"values": [
"Ophalen of Verzenden",
"Ophalen",
"Verzenden"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
}
]
}
]
},
{
"categoryId": 859,
"attributes": [
{
"portal": "tweedehands",
"locale": "nl_NL",
"attributes": [
{
"key": "situated",
"label": "Ligging",
"type": "STRING",
"values": [
"Dorp",
"Stad",
"Landelijk",
"Recreatiepark",
"Overige"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "surroundings",
"label": "Omgeving",
"type": "LIST",
"values": [
"Aan zee",
"Aan meer of rivier",
"In bergen of heuvels",
"In bos",
"In wintersportgebied"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
},
{
"key": "extras",
"label": "Extra's",
"type": "LIST",
"values": [
"Afwasmachine",
"Airconditioning",
"Huisdier toegestaan",
"Internet",
"Jacuzzi",
"Kinderbed",
"Open haard",
"Rolstoelvriendelijk",
"Sauna",
"Speeltuin",
"Tuin",
"Tv",
"Wasmachine",
"Zwembad"
],
"minimum": 0,
"maximum": 0,
"unit": "",
"mandatory": false,
"searchable": true,
"writable": false,
"updatable": true
}
]
}
]
}
]
}