Advertisements

Collection of advertisement representations.

You create new advertisements posting to this collection. To see what fields you should post and what errors you can expect when creating advertisements look at the documentation for the advertisement resource.

Relations

name	availability	embedded	cardinality
item	always	no	1

Reference

GET /v1/advertisements

Collection of advertisements.

POST /v1/advertisements

Create a new advertisement.

For updating existing advertisements, please see updating an advertisement.

Examples

Retrieving the advertisements collection :

Request :

GET /v1/advertisements HTTP/1.1
Host: api.marktplaats.nl

Response :

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

{
  "_links": {
    "self": {
      "href": "/v1/advertisements",
      "title": "Access to advertisements"
    },
    "describedby": {
      "href": "https://api.marktplaats.nl/docs/v1/advertisements.html"
    },
    "item": {
      "href": "/v1/advertisements/{itemId}",
      "templated": true
    }
  }
}

Creating a new advertisement :

Request :

POST /v1/advertisements/ HTTP/1.1
Host: api.marktplaats.nl
Content-Type: application/json

{
  "description": "Brand new bike",
  "title": "test advertisement",
  "categoryId": 2,
  "location": {
    "postcode": "1097DN"
  },
  "priceModel" : {
    "modelType" : "fixed",
    "askingPrice" : 1550
  }
}