# Marktplaats Listing API Documentation

Retrieve one public Marktplaats.nl listing by id: title, plain-text description, url, price in euros with currency, price type, category id, city and country, seller id, name and type, images, attributes, status, creation date (ISO 8601, UTC), view count and favorite count. Seller contact data is never returned. An unknown id returns a 404 error that is not billed.

- **Documentation:** [https://scrappa.co/docs/marktplaats-api/marktplaats_listing](https://scrappa.co/docs/marktplaats-api/marktplaats_listing)
- **API group:** Marktplaats API
- **Endpoint:** `GET https://scrappa.co/api/marktplaats/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | Marktplaats listing id from the search endpoint, e.g. m2119107775. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/marktplaats/listing?id=m2119107775"
```

## Example response

```json
{
    "success": true,
    "data": {
        "listing": {
            "id": "m2119107775",
            "title": "Dames fietsen heren fietsen oma fietsen",
            "description": "Zeer grote voorraad bij 020 fietsen Amsterdam\n\nDames fietsen\nHeren fietsen\nOma fietsen\nTransport fietsen\n\nElke week nieuwe aanvoer!!\n\nFietsen hebben wij al vanaf \u20ac99,-\nKom snel langs!\n\n\u2022 - Onze klanten beoordelen ons met 4,8/5. Lees de reviews!\n\n\u2022 Ruim assortiment tweedehands fietsen\n\u2022 Laagste prijzen\n\u2022 A",
            "url": "https://www.marktplaats.nl/m2119107775",
            "price": 99,
            "currency": "EUR",
            "price_type": "fixed",
            "category_id": 447,
            "location": {
                "city": "Amsterdam",
                "country": "Nederland"
            },
            "seller": {
                "id": 19190757,
                "name": "020-Fietsen B.V.",
                "type": "trader"
            },
            "images": [
                "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/23/232cb473-a61d-45c8-b7ad-355f3d3e6ce1?rule=ecg_mp_eps$_83.jpg",
                "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/79/79ba9263-de8a-4af5-b869-55a4a36e1ac7?rule=ecg_mp_eps$_83.jpg",
                "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/51/5192c45d-61c9-4f63-a55f-7964556666de?rule=ecg_mp_eps$_83.jpg"
            ],
            "attributes": {
                "condition": "Gebruikt",
                "brand": "Overige merken",
                "delivery": "Ophalen of Verzenden"
            },
            "status": "active",
            "created_at": "2024-05-26T06:23:56Z",
            "view_count": 9255,
            "favorited_count": 137,
            "is_shippable": true
        }
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable and makes no upstream request. |
| 404 | Resource Not Found | The requested Marktplaats listing does not exist. This response is not billable. |
| 503 | Invalid Source Response | Marktplaats answered with a shape that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)