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.

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
  }
}