ImmoScout24 Listing Data Through a Managed Scraping API
Collecting German property listings by hand gets slow as soon as you cover more than a handful of postcodes.
A managed scraping API takes over the browser, proxy and anti-bot work so your code only has to send a URL and read the result. This guide explains what the ImmoScout24 workflow returns, which request options change the output and cost, and how to choose between rendered HTML and structured JSON.
What the API does with an ImmoScout24 URL
You send an ImmoScout24 listing or search URL to the API. The service renders the page on immobilienscout24.de, deals with anti-bot measures, and returns either rendered HTML or structured JSON. JSON is produced when you supply extraction rules or an AI extraction spec.
The listing attributes the page describes include asking price or rent, square metres, room count, Postleitzahl (postal code), neighbourhood, year built, agent name, days on market and the image gallery. Treat those as the fields the workflow is designed to surface; confirm the actual response shape against the documentation before you build a schema around it.
The request flow, step by step
- Create an account to obtain an API key. The signup includes 1,000 free credits and does not require a card.
- Install a client library if you want one. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java; plain cURL also works.
- Send the ImmoScout24 URL with POST or GET. The service renders the page and returns HTML by default.
- Add options when the default is not enough: render_js for JavaScript, stealth_proxy for tougher anti-bot situations, country_code for geo-targeting, and ai_extract_rules for natural-language extraction.
A request builder in the dashboard lets you test a call without writing code first.
Choosing an output format: HTML, CSS rules or AI rules
The three output paths suit different stages of a project.
- Rendered HTML is the default. Use it when you want to inspect the page yourself or when your own parser already exists.
- extract_rules maps CSS selectors to field names. Use it when the listing layout is stable and you want deterministic field mapping.
- ai_extract_rules takes a natural-language description of the fields you want. Use it when the layout shifts or when writing selectors would take longer than describing the result.
Both rule-based paths return parsed JSON, so downstream code does not have to parse HTML. A practical sequence is to prototype with rendered HTML, lock the field names you need, then move to extract_rules once the selectors are stable.
Listing field map
The following table summarises the listing attributes the page associates with an ImmoScout24 result and what each is useful for. It is a planning aid, not a guaranteed response schema.
How options change credit cost
Credits are consumed per successful request, and the option set determines how many. The supplied figures are:
- Base request: from 1 credit.
- JavaScript rendering enabled: 5 credits.
- Premium proxy with JavaScript rendering disabled: 10 credits.
- Premium proxy with JavaScript rendering enabled: 25 credits.
- stealth_proxy: 75 credits.
Worked example: a run of 1,000 listing requests with JavaScript rendering enabled consumes about 5,000 credits. The same 1,000 requests routed through stealth_proxy consume about 75,000 credits, which is the entire Hobby plan allowance. Estimate your monthly request volume against the option mix before choosing a plan.
API credits are valid for one month and do not roll over.
Plan limits at a glance
Each plan pairs a monthly credit allowance with a concurrency ceiling. Concurrency is the number of requests that can be in flight at the same time, not a per-target rate limit. If ImmoScout24 throttles aggressive patterns, space out requests or use multiple sessions rather than raising concurrency.
JavaScript rendering, rotating and premium proxies, geotargeting, and screenshots and extraction rules are included on every plan. Priority email support, a dedicated account manager and team management appear from the Business plan upward. All prices are exclusive of VAT.
Plan prices and allowances are commercial terms that need owner confirmation before publication.
Country targeting
Pass country_code on the request to route through a residential IP in that country. This matters when listing content or availability varies by geography. The geotargeting capability is included on every plan.
Common research workflows
Three patterns recur in ImmoScout24 data work:
- Rental and sale comparison across postcodes. Pull listings for each Postleitzahl you cover and compare price per square metre, time on market and competitor agency inventory.
- Rental price analysis. Collect structured price data by region to study trends, demand and pricing strategy.
- Agent contact collection. Centralise agent contact details for outreach or partner collaboration.
Each pattern maps to a different field subset, so define the fields you need before choosing extract_rules or ai_extract_rules.
Data handling and compliance
The service states that it does not collect or store personal data from scraped sites unless the user explicitly requests it. Agent contact details are personal data in many jurisdictions, so confirm your own legal basis before collecting them. The compliance claims on this page are publisher statements that need owner confirmation before publication.
| Field | What it tells you | Typical use |
|---|---|---|
| Asking price or rent | The headline price on the listing | Price comparison across postcodes |
| Square metres | Living area | Price per square metre calculation |
| Room count | Number of rooms | Segmenting listings by property type |
| Postleitzahl | German postal code | Regional grouping and coverage checks |
| Neighbourhood | Local area name | Sub-market analysis |
| Year built | Construction year | Age-adjusted price comparison |
| Agent name | Listing agent | Contact collection and competitor tracking |
| Days on market | Time since listing | Demand and liquidity signals |
| Image gallery | Listing photos | Visual review and documentation |
Field availability depends on what each listing publishes; confirm the response shape against the documentation.
| Option | Credits per successful request |
|---|---|
| Base request | from 1 |
| JavaScript rendering | 5 |
| Premium proxy, JS rendering disabled | 10 |
| Premium proxy, JS rendering enabled | 25 |
| stealth_proxy | 75 |
Figures are the supplied per-request credit costs; confirm current pricing before budgeting.
| Plan | Monthly price | API credits | Concurrent requests |
|---|---|---|---|
| Hobby | $19 /mo | 75,000 | 25 |
| Freelance | $49 /mo | 250,000 | 50 |
| Startup (Recommended) | $99 /mo | 1,000,000 | 100 |
| Business | $249 /mo | 3,000,000 | 200 |
| Business + | $599 /mo | 8,000,000 | 400 |
| Enterprise 14 | $999 /mo | 14,000,000 | 500 |
| Enterprise 24 | $1,599 /mo | 24,000,000 | 600 |
| Enterprise 41 (Recommended) | $2,399 /mo | 41,000,000 | 700 |
| Enterprise 69 | $3,599 /mo | 69,000,000 | 800 |
| Enterprise 120 | $5,799 /mo | 120,000,000 | 900 |
All prices are exclusive of VAT. Plan prices and allowances are commercial terms requiring owner confirmation before publication.
Frequently asked questions
Do I need an ImmoScout24 account to use the API?
No external account is needed. You sign up for an API key, which includes 1,000 free credits and requires no card, then send the URL and the service handles the rest.
Can I target a specific country?
Yes. Pass country_code on the request to route through a residential IP in that country. This is useful when listing content varies by geography.
Is there a per-target rate limit?
Limits are set by concurrency per plan, not per target. If ImmoScout24 throttles aggressive request patterns, space out requests or use multiple sessions.
How do I get structured JSON instead of HTML?
Supply extract_rules with CSS selectors mapped to field names, or ai_extract_rules with a natural-language description of the fields. The response is returned as parsed JSON.
Which languages can I use?
Any language that can make an HTTP request. SDKs are published for Python, Node.js, Go, PHP, Ruby and Java, and plain cURL works too.
What does it cost to collect ImmoScout24 data?
Signup includes 1,000 free credits with no card. Paid plans start at $19 per month for higher volume and concurrency. Credit cost per request depends on options: 5 credits for JavaScript rendering, 25 for a premium proxy with JavaScript rendering, and 75 for stealth_proxy. Credits are valid for one month and do not roll over.
Should I start with rendered HTML or JSON extraction?
Start with rendered HTML while you inspect the listing layout and decide which fields matter. Once the selectors are stable, move to extract_rules for deterministic JSON, or ai_extract_rules if the layout changes often.