Categories

Categories for the basic taxonomy in which advertisements on Marktplaats are placed. They represent a context for the advertisements and allow for structure.

The Categories resource makes the Marktplaats categories structure available to the API user. There are L1 and L2 categories. L1 categories group several L2 categories. Advertisements can only be placed in L2 categories.

The category structure is read-only.

Fields

Each category has a unique identifier by which it can be retrieved and a set of fields which are listed below:

field	type	constraints	default	Req	W	U
categoryId	int	positive		yes	no	no
name	string	max. 70 characters		yes	no	no
labels	object	–		yes	no	no
status	string	either open or closed, where open is the normal state for a category.		yes	no	no

categoryId

Unique reference to a Marktplaats category.

name

The descriptive name of the category. Deprecated: Use labels instead.

labels

The localized descriptive names of the category, keyed by locale.

status

When open, it is possible to place new advertisements in this category. When status is closed, it is not possible to place new advertisements in this category and an error will be returned when tried.

Relations

name	availability	embedded	cardinality
mp:category-attributes	Category is a L2 category.	no	1
up	Category is a L1 category.	no	1
mp:category	If there are child categories	yes	0..N

Reference

GET /v1/categories

This URL returns all categories.

GET /v1/categories/{categoryId}

This URL returns a L1 category, and embeds its children. No advertisements can be placed in this category.

GET /v1/categories/{l1CategoryId}/{l2CategoryId}

This URL returns a L2 category. You can place advertisements in this category.

GET /v1/categories?categoryId={categoryId}

This URL returns a L1 or L2 category, and embeds its children if present.

Errors

http	error code	description
404	category-not-found	The category does not exist.

Example

Retrieving a sub category :

Request :

GET /v1/categories/1/2 HTTP/1.1
Host: api.marktplaats.nl

Response :

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

{
  "_links": {
    "self": {
      "href": "/v1/categories/1/2"
    },
    "find": {
      pom"href": "/v1/categories{?categoryId}",
      "templated": true
    },
    "describedby": {
      "href": "https://api.marktplaats.nl/docs/v1/categories.html"
    },
    "curies": [
      {
        "href": "https://api.marktplaats.nl/docs/v1/rels/{rel}.html",
        "templated": true,
        "name": "mp"
      }
    ],
    "up": {
      "href": "/v1/categories/1"
    },
    "mp:category-attributes": {
      "href": "/v1/categories/1/2/attributes"
    }
  },
  "categoryId": 2,
  "name": "Antiek | Bestek",
  "labels": {
      "nl-NL": "Antiek | Bestek"
  },
  "status": "open"
}