# Commercial Listing Search

Searches commercial listings with location, type, rent/buy, price, area and page filters. Each page holds 50 listings. Page labels come from the upstream result.

- **Documentation:** [https://scrappa.co/docs/german-commercial-real-estate-api/commercial_is24_search](https://scrappa.co/docs/german-commercial-real-estate-api/commercial_is24_search)
- **API group:** German Commercial Real Estate API
- **Endpoint:** `GET https://scrappa.co/api/commercial/is24/search`

## 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 |
| --- | --- | --- | --- |
| `location` | string | Yes | Geocode path or id from the commercial locations route. |
| `type` | string | No | office, store, gastronomy, tradesite or specialpurpose. |
| `listing_type` | string | No | rent (default), buy or all. A price filter needs rent or buy. |
| `price_min` | integer | No | Minimum price. EUR per m2 per month for rent, EUR total for buy. Rows without a price or in another unit are skipped. |
| `price_max` | integer | No | Maximum price. EUR per m2 per month for rent, EUR total for buy. Rows without a price or in another unit are skipped. |
| `size_min` | integer | No | Minimum area in square metres. |
| `size_max` | integer | No | Maximum area in square metres. |
| `rooms_min` | number | No | Minimum number of rooms. |
| `rooms_max` | number | No | Maximum number of rooms. |
| `page` | integer | No | Result page, 1-based. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/commercial/is24/search?location=%2Fde%2Fberlin%2Fberlin&type=office&listing_type=rent&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "total": 12216,
        "page": 1,
        "per_page": 50,
        "total_pages": 245,
        "listings": [
            {
                "id": "165221493",
                "title": "Office in Berlin",
                "real_estate_type": "office",
                "price": 2440,
                "price_unit": "per_month",
                "currency": "EUR",
                "size_m2": 137,
                "listing_type": "rent",
                "refreshed_at": "2026-11-19T09:00:00+01:00",
                "image_url": "https://pictures.immobilienscout24.de/listings/full.jpg",
                "url": "https://www.immobilienscout24.de/expose/165221493"
            }
        ]
    },
    "meta": {
        "endpoint_family": "is24_commercial",
        "attempts": 1
    }
}
```

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