# Kamernet Listing Details API Documentation

Scrappa's `GET /api/kamernet/listing` returns the full record of one Kamernet.nl rental.

## What you get

`price` has `rent`, `total_rent`, `utilities_included`, `deposit`, `agency_fee` with an English and Dutch description, `registration_cost` and `internet_additional_costs`. `space` has `surface_m2`, `bedrooms` and `rooms` (often null, shown only when Kamernet has them), `furnishing`, `energy_label`, and shower, kitchen, toilet, living room and internet as `private`, `shared`, `none` or similar labels. `title` and `description` come in English and Dutch. `dates` has the created, published, availability and viewing dates as Kamernet gives them (Dutch local time, no zone). `rules` holds the tenant rules: pets, smoking, registration, age range, gender, work status, persons and housemates. `images` and `thumbnails` are full URLs in gallery order. `suggested_listings` has cards of similar homes.

## Address and coordinates

The address has street, house number, postal code and city. `latitude` and `longitude` are the centre of the postal code, not the exact home. `geo_precision` says `postal_code_centroid`.

## Landlord profile

Kamernet has no separate landlord page. The `landlord` block is the public profile: `name`, `type` (private, roommate, agent or other), `member_since`, `last_logged_on`, `response_rate`, `response_time`, `active_listings_count`, `bank_verified` and `id_verified`. Messaging and contact details are not part of this API.

## Unknown ids

An id that does not exist or has expired returns `404` (`not_found`) and is never billed.

- **Documentation:** [https://scrappa.co/docs/kamernet-api/kamernet_listing](https://scrappa.co/docs/kamernet-api/kamernet_listing)
- **API group:** Kamernet API
- **Endpoint:** `GET https://scrappa.co/api/kamernet/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 | Numeric listing id from the search endpoint. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "platform": "kamernet",
    "listing": {
        "id": 2414003,
        "url": "https://kamernet.nl/en/for-rent/room-diemen/botterweg/room-2414003",
        "type": "room",
        "status": "active",
        "title": {
            "en": "Room in Diemen-Noord",
            "nl": "Kamer in Diemen-Noord"
        },
        "description": {
            "en": "Hi! My housemate and I are looking for a new housemate.",
            "nl": "Hoi, ik en mijn huisgenoot zoeken een nieuwe huisgenoot."
        },
        "price": {
            "rent": 1300,
            "total_rent": 1300,
            "utilities_included": true,
            "deposit": 2600,
            "agency_fee": null,
            "agency_fee_description": {
                "en": null,
                "nl": null
            },
            "registration_cost": null,
            "internet_additional_costs": null,
            "currency": "EUR"
        },
        "space": {
            "surface_m2": 128,
            "bedrooms": null,
            "rooms": null,
            "furnishing": "furnished",
            "energy_label": "unknown",
            "shower": "shared",
            "kitchen": "shared",
            "toilet": "shared",
            "living_room": "shared",
            "internet": "available"
        },
        "address": {
            "street": "Botterweg",
            "house_number": "14",
            "postal_code": "1113HT",
            "city": "Diemen",
            "city_slug": "diemen",
            "latitude": 52.347846,
            "longitude": 4.977093,
            "geo_precision": "postal_code_centroid"
        },
        "dates": {
            "created": "2026-10-25T19:07:29.863",
            "published": "2026-10-25T23:48:20.543",
            "available_from": "2026-11-01T19:07:24",
            "available_to": null,
            "viewing": null
        },
        "rules": {
            "pets_allowed": false,
            "smoking_allowed": null,
            "registration_allowed": null,
            "candidate_min_age": 21,
            "candidate_max_age": 30,
            "candidate_gender": "male",
            "candidate_statuses": [
                "student",
                "working_student",
                "working"
            ],
            "suitable_for_persons": 1,
            "housemates": null,
            "housemates_gender": null
        },
        "images": [
            "https://resources.kamernet.nl/image/8a3e62b5-8499-454e-a179-27f2701d3df3"
        ],
        "thumbnails": [
            "https://resources.kamernet.nl/image/50c6dca2-b4ca-428e-ae0e-91f174dbeb5f"
        ],
        "video_ids": [],
        "landlord": {
            "name": "Christian",
            "type": "private",
            "member_since": "2022-07-08",
            "last_logged_on": "2026-10-26",
            "response_rate": 0,
            "response_time": null,
            "active_listings_count": 0,
            "bank_verified": true,
            "id_verified": false
        },
        "suggested_listings": [
            {
                "id": 2414003,
                "url": "https://kamernet.nl/en/for-rent/room-diemen/botterweg/room-2414003",
                "type": "room",
                "street": "Botterweg",
                "city": "Diemen",
                "city_slug": "diemen",
                "city_id": 4,
                "surface_m2": 14,
                "total_rent": 650,
                "currency": "EUR",
                "utilities_included": true,
                "furnishing": "furnished",
                "available_from": "2026-11-01T19:07:24",
                "available_to": null,
                "is_new": true,
                "is_student_house": false,
                "thumbnail_url": "https://resources.kamernet.nl/image/50c6dca2-b4ca-428e-ae0e-91f174dbeb5f",
                "image_url": "https://resources.kamernet.nl/image/8a3e62b5-8499-454e-a179-27f2701d3df3"
            }
        ]
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true,
        "attempts": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No listing exists with that id on Kamernet (`not_found`), for example because it expired. Non-billable. |
| 422 | Validation Error | A query parameter is missing, unknown or unusable (`invalid_filter`). Unknown parameters and unknown list values are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | Kamernet could not be reached, refused the request, or answered with data this API could not read (`upstream_unavailable`, `upstream_blocked`, `parser_drift`). Retryable and never billed. Clients are never rate limited. |

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