# Marktplaats Auto's Facets API Documentation

The 41 Marktplaats Auto's filter facets: AttributeGroupFacet (advertiser, priceType, fuel, transmission, body, color, upholstery, driveTrain, condition, energyLabel, options, hybridType, warranty, APK, imported, fuelConsumption, euronormBE, napNationalCarPass, serviceHistory, offeredSince), AttributeRangeFacet (PriceCents, constructionYear, mileage, engineHorsepower, engineDisplacement, range, batteryCapacity, emptyWeightCars, roadTax, towingWeightBrakes) and CategoryTreeFacet (RelevantCategories). Use attributeValueId values as attributesById filters in the search endpoint. The list is embedded in the search response and cached briefly.

- **Documentation:** [https://scrappa.co/docs/marktplaats-autos-api/marktplaats_autos_facets](https://scrappa.co/docs/marktplaats-autos-api/marktplaats_autos_facets)
- **API group:** Marktplaats Auto's API
- **Endpoint:** `GET https://scrappa.co/api/marktplaats-autos/facets`

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

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/marktplaats-autos/facets?domain=www.marktplaats.nl"
```

## Example response

```json
{
    "success": true,
    "data": {
        "facets": [
            {
                "type": "AttributeGroupFacet",
                "key": "fuel",
                "values": [
                    {
                        "attributeValueId": 473,
                        "attributeValueLabel": "Benzine",
                        "histogramCount": 166490
                    },
                    {
                        "attributeValueId": 474,
                        "attributeValueLabel": "Diesel"
                    }
                ]
            },
            {
                "type": "AttributeRangeFacet",
                "key": "PriceCents"
            }
        ]
    },
    "meta": {
        "endpoint_family": "facets"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A public parameter is invalid. 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)