ImmoScout24 Search

Search and retrieve property listings from ImmoScout24.de using their mobile API. No browser needed — bypasses DataDome anti-bot completely.

Prerequisites

Requires immoscout Python package:

pip3 install --break-system-packages immoscout

Quick Start

Search listings

# Apartments for sale in Passau area, max €300k, 2+ rooms
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --min-rooms 2

# Houses for sale in Passau area, max €350k
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type housebuy --max-price 350000

# JSON output for machine processing
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --format json

Get expose details (heating, energy, parking)

python3 scripts/immoscout24-search.py --expose 166875438
python3 scripts/immoscout24-search.py --expose 166875438 --format json

Expose details include:

• Heizungsart (heating type): Zentralheizung, Fußbodenheizung, Etagenheizung, etc.
• Energieträger (energy source): Erdgas, Fernwärme, Wärmepumpe, Öl, Pellets, etc.
• Garage/Stellplatz (parking): Tiefgarage, Carport, Stellplatz, etc.
• Baujahr (year built), Objektzustand (condition)
• Energieverbrauchskennwert (energy rating)
• Internal fields: obj_heatingType, obj_parkingSpace, obj_condition, obj_purchasePrice

Real Estate Types

Region Format

Regions use the path format: /de/{bundesland}/{kreis-oder-stadt}

Common regions:

Parameters

Typical Workflow for Property Reports

1. Search multiple regions and types:

python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type apartmentbuy --max-price 300000 --min-rooms 2 --format json > /tmp/is24-apt.json
python3 scripts/immoscout24-search.py --region /de/bayern/passau-kreis --type housebuy --max-price 350000 --format json > /tmp/is24-house.json

1. Get expose details for interesting listings to check heating type:

python3 scripts/immoscout24-search.py --expose 166875438 --format json

1. Filter based on heating, condition, energy rating, parking.

1. Compile report with URLs, prices, heating info, and location details.

Notes

• Uses IS24 mobile API (api.mobile.immobilienscout24.de) — no browser or authentication needed
• Rate limiting is lenient but don't hammer it — add small delays between expose lookups
• Listing URLs follow pattern: https://www.immobilienscout24.de/expose/{id}
• Search returns: id, title, price, area, rooms, address, postcode, published date
• Expose returns: full details including heating, energy, parking, condition, year built