# Marktplaats Auto's Listing API Documentation

Full detail for one Marktplaats.nl or 2dehands.be car listing: price with price type, description, gallery images, all vehicle specs (first registration, mileage, power, fuel, transmission, CO2 and consumption where public), the equipment list, seller and dealer info without private contact data, location, first registration and listing stats. A sold or removed listing fails non-billable.

- **Documentation:** [https://scrappa.co/docs/marktplaats-autos-api/marktplaats_autos_listing](https://scrappa.co/docs/marktplaats-autos-api/marktplaats_autos_listing)
- **API group:** Marktplaats Auto's API
- **Endpoint:** `GET https://scrappa.co/api/marktplaats-autos/listing/{itemId}`

## 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 |
| --- | --- | --- | --- |
| `domain` | string | Yes | Marketplace host: www.marktplaats.nl or www.2dehands.be |
| `itemId` | string | Yes | Listing id returned by search, e.g. m2451834523. |
| `make` | string | No | Make URL segment of the listing, e.g. audi. Optional; the upstream resolves by item id. |
| `slug` | string | No | Title slug of the listing. Optional; the upstream resolves by item id. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/marktplaats-autos/listing/{itemId}?domain=www.marktplaats.nl&itemId=m2451834523"
```

## Example response

```json
{
    "success": true,
    "data": {
        "itemId": "m2451834523",
        "title": "Audi Q5 2.0 Tfsi Quattro S-tronic (m2451834523) \u2014 Audi \u2014 Marktplaats",
        "url": "https://www.marktplaats.nl/v/auto-s/audi/m2451834523-audi-q5-2-0-tfsi-quattro-s-tronic",
        "price": {
            "priceCents": 695000,
            "priceType": "MIN_BID"
        },
        "location": {
            "city": "Castricum",
            "country": "NL"
        },
        "images": [
            "https://images.marktplaats.com/api/v1/hz-mp-pro-listing/images/af081d77-a130-4965-85e6-5edd9d742e1c?rule=ecg_mp_eps$_82.jpg"
        ],
        "specs": {
            "firstRegistration": 2013,
            "mileage": {
                "value": 123456,
                "unit": "km"
            },
            "power": {
                "value": 190,
                "unit": "pk"
            },
            "fuel": "Benzine",
            "transmission": "Automaat"
        },
        "seller": {
            "id": 7796188,
            "name": "Richard"
        },
        "stats": {
            "viewCount": 1234
        }
    },
    "meta": {
        "endpoint_family": "listing"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. This response is not billable. |  |
|  | The listing was sold or removed. This response is not billable. |  |
|  | Marktplaats did not return usable data for this request. This response is not billable. |  |

## 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)