# ImmoScout24 CH Listing Detail API Documentation

Fetch one public ImmoScout24 Switzerland listing by id: categories, price (CHF), rooms, living space, floor, features such as balcony and elevator, address with coordinates, image urls, documents, the agency with legal name, logo and website, availability date, created and updated timestamps, text in all four languages and the public listing url. An unknown id answers a non-billable 404.

- **Documentation:** [https://scrappa.co/docs/immoscout24-ch-api/immoscout24_ch_listing](https://scrappa.co/docs/immoscout24-ch-api/immoscout24_ch_listing)
- **API group:** ImmoScout24 CH API
- **Endpoint:** `GET https://scrappa.co/api/immoscout24-ch/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: 4003373005. |
| `lang` | string | No | Main text language: de, fr, it or en. All languages also appear in localizations. Defaults to de. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "data": {
        "id": "4003373005",
        "offer_type": "rent",
        "categories": [
            "APARTMENT",
            "FLAT"
        ],
        "title": "Zentrale 3-Zimmer-Wohnung mit Balkon",
        "description": "Helle Wohnung in ruhiger Lage, nahe Tram und Einkauf.",
        "language": "de",
        "localizations": {
            "de": {
                "title": "Zentrale 3-Zimmer-Wohnung mit Balkon"
            },
            "en": {
                "title": "Central 3-room apartment with balcony"
            }
        },
        "price": {
            "currency": "CHF",
            "gross": 2310,
            "net": 2100,
            "interval": "MONTH"
        },
        "rooms": 3,
        "living_space": 68,
        "floor": 3,
        "features": {
            "has_balcony": true,
            "has_elevator": true,
            "year_built": 1998
        },
        "address": {
            "street": "Brunnenstrasse 22",
            "postal_code": "8610",
            "locality": "Uster",
            "region": "ZH",
            "country": "CH",
            "geoTags": [
                "geo-canton-zurich",
                "geo-city-uster"
            ],
            "latitude": 47.3511,
            "longitude": 8.7225
        },
        "images": [
            "https://media2.homegate.ch/listings/v2/z927/4003373005/image/b002cd67dead2640a1d0f0b75f66055d.jpg"
        ],
        "lister": {
            "id": "z927",
            "name": "Example Immobilien AG",
            "website": "https://www.example-immobilien.ch/"
        },
        "platforms": [
            "immoscout24",
            "homegate"
        ],
        "available_from": "2026-11-01",
        "created_at": "2026-08-10T11:04:34Z",
        "updated_at": "2026-10-12T17:42:40Z",
        "url": "https://www.immoscout24.ch/rent/4003373005"
    },
    "meta": {
        "endpoint_family": "listing",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A parameter is missing or invalid. This response is not billable. |
| 404 | Listing Not Found | The source has no matching resource. This response is not billable. |
| 503 | Source Unavailable | The source is temporarily unreachable or blocked the request. Retry later; 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)