# Immowelt Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/immowelt/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/immowelt-search |

## Description

Search Immowelt listings from a search URL and retrieve prices, specs, photos, agency info, and pagination.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/immowelt/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search apartments for rent in Germany

```json
{
  "results": [
    {
      "id": "26Y9EVQUEN6D",
      "cps": "26Y9EVQUEN6D",
      "url": "https://www.immowelt.de/expose/b4a08c88-83bf-46b0-a5a5-9a2c91051737",
      "tags": {
        "is_new": false,
        "has3_d_visit": false,
        "is_exclusive": false,
        "has_brokerage_fee": false
      },
      "type": "PROFESSIONAL",
      "brand": "immowelt",
      "portal": "immowelt",
      "status": "Published",
      "display": "classified",
      "gallery": {
        "images": [
          {
            "alt": "Studio zur Miete 530 € 1 Zimmer 22 m² 1. Geschoss frei ab sofort Neuffener Str. 61 Nürtingen 72622",
            "key": "baf51e9e-a514-4f29-99f0-bc35b4be3b94",
            "url": "https://mms.immowelt.de/b/a/f/5/baf51e9e-a514-4f29-99f0-bc35b4be3b94.jpg?ci_seal=37711d30b4599fff1634abf0c74393be07f600b2",
            "title": "Außenansicht",
            "aria_label": "Außenansicht",
            "description": "Außenansicht"
          },
          {
            "key": "0bd9a17d-e22c-4e87-ba9d-42b3a7028eec",
            "url": "https://mms.immowelt.de/0/b/d/9/0bd9a17d-e22c-4e87-ba9d-42b3a7028eec.jpg?ci_seal=3bbf4ba58dbba3745a76c810ddc7d182d9e35fe9",
            "title": "Blick ins Bad - Waschtisch und WC",
            "aria_label": "Blick ins Bad - Waschtisch und WC",
            "description": "Blick ins Bad - Waschtisch und WC"
          }
        ]
      },
      "location": {
        "address": {
          "city": "Nürtingen",
          "street": "Neuffener Str. 61",
          "country": "DEU",
          "zip_code": "72622"
        },
        "is_address_published": true
      },
      "metadata": {
        "id": "26Y9EVQUEN6D",
        "status": {
          "status": true,
          "enrichments": {
            "geo": false,
            "media": false,
            "online_id": false,
            "intermediary": false,
            "contact_settings": false
          }
        },
        "legacy_id": "b4a08c88-83bf-46b0-a5a5-9a2c91051737",
        "update_date": "2026-05-26T13:20:35.489Z",
        "creation_date": "2026-05-26T13:15:51.95Z"
      },
      "provider": {
        "badge": {
          "title": "Diamond Partner",
          "image_url": "https://s.immowelt.org/shared/images/partner-badges/diamond-partner.svg"
        },
        "address": "Keplerstr. 21, 72810 Gomaringen",
        "website": "http://www.fvi-gmbh.de/",
        "imprint_url": "https://www.immowelt.de/profil/4ef6f9a229724bda8300b7a39c51e143#impressum",
        "profile_url": "https://www.immowelt.de/profil/4ef6f9a229724bda8300b7a39c51e143",
        "agency_strip": {
          "font_color": "#FFFFFF",
          "agency_color": "#da0001"
        },
        "contact_card": {
          "title": "Herr Walter Restle",
          "display": true,
          "logo_url": null,
          "subtitle": "Dein Kontakt"
        },
        "display_links": true,
        "phone_numbers": [
          "07072-89 000 64"
        ],
        "publisher_type": "AGENCY",
        "is_private_owner": false,
        "intermediary_card": {
          "title": "FVI GmbH",
          "display": true,
          "logo_url": "https://mms.immowelt.de/c/8/1/9/c819d63d-0aa6-4a5d-a325-f7bff214b06f.jpg?ci_seal=a97092648fa5b75def1b5873b3adf65ac47c0444",
          "subtitle": "Gewerblicher Anbieter",
          "logo_href": "https://www.immowelt.de/profil/4ef6f9a229724bda8300b7a39c51e143"
        },
        "agency_legal_informations": []
      },
      "raw_data": {
        "price": 670,
        "nbroom": 1,
        "surface": {
          "main": 22,
          "plot": null
        },
        "providercity": "Gomaringen",
        "property_type": "APARTMENT",
        "providerzipcode": "72810",
        "geo_id_hierarchy": [
          {
            "id": "NBH2DE91300073",
            "type_key": "NBH2"
          },
          {
            "id": "AD08DE5294",
            "type_key": "AD08"
          },
          {
            "id": "AD06DE182",
            "type_key": "AD06"
          },
          {
            "id": "AD05DE9",
            "type_key": "AD05"
          },
          {
            "id": "AD04DE8",
            "type_key": "AD04"
          },
          {
            "id": "AD02DE1",
            "type_key": "AD02"
          }
        ],
        "distribution_type": "RENT",
        "property_sub_type": "STUDIO",
        "offerer_marketing_key": "AP50",
        "contact_location_enabled": false
      },
      "tracking": {
        "id": "26Y9EVQUEN6D",
        "city": "Nürtingen",
        "name": "classified",
        "price": 530,
        "region": "Baden-Württemberg",
        "country": "Germany",
        "currency": "EUR",
        "zip_code": "72622",
        "client_id": "1525951",
        "legacy_id": "b4a08c88-83bf-46b0-a5a5-9a2c91051737",
        "list_name": "classified_detail_similars_bottom",
        "estate_type": "av_2",
        "product_type": "standard",
        "building_state": "MINT_CONDITION",
        "distribution_type": "1",
        "energy_certificate": "A"
      },
      "hard_facts": {
        "facts": [
          {
            "type": "numberOfRooms",
            "label": "Zimmer",
            "value": "1 Zimmer",
            "split_value": "1"
          },
          {
            "type": "livingSpace",
            "label": "m²",
            "value": "22 m²",
            "split_value": "22"
          },
          {
            "type": "numberOfFloors",
            "label": "Geschoss",
            "value": "1. Geschoss",
            "split_value": "1."
          },
          {
            "type": "availability",
            "label": "ab sofort",
            "value": "frei ab sofort",
            "split_value": "frei"
          }
        ],
        "price": {
          "value": "530 €",
          "addition": {
            "value": "Kaltmiete"
          },
          "formatted": "530 €",
          "aria_label": "530 €",
          "financial_link": {
            "href": "https://www.immowelt.de/immobilienfinanzierung-anfragen/?price=530&originvariant=expose-hardfacts&zip=72622&city=Nürtingen&classifiedid=b4a08c88-83bf-46b0-a5a5-9a2c91051737&m=classified_detail_request_offer_find_financing_partners_step1",
            "label": "Finanzierung anfragen",
            "partner_name": "KFW"
          },
          "additional_information": "Kaltmiete"
        },
        "title": "Studio zur Miete",
        "prices": [
          {
            "label": "Kaltmiete",
            "value": "530 €",
            "aria_label": "530 €"
          },
          {
            "label": "Warmmiete",
            "value": "670 €",
            "aria_label": "670 €"
          }
        ],
        "keyfacts": [
          "1 Zimmer",
          "22 m²",
          "1. Geschoss",
          "frei ab sofort"
        ]
      },
      "energy_class": "A",
      "card_provider": {
        "title": "Herr Walter Restle",
        "logo_url": null,
        "subtitle": "Dein Kontakt",
        "agency_strip": {
          "font_color": "#FFFFFF",
          "agency_color": "#da0001"
        }
      },
      "main_description": {
        "headline": "Gepflegtes, möbliertes Mikroappartement",
        "metadata": {
          "language": "de"
        },
        "description": "Objektbeschreibung Diese traumhafte Wohnung ist Teil einer gepflegten, aus insgesamt 66 Wohneinheiten bestehenden Wohnanlage. Raumaufteilung Das Mikroappartment besteht aus einem einzelnen, großen Zimmer sowie dem Bad/WC; Heizkörper suchen Sie hier übrigens vergebens - für Wärme sorgt in der gesamten Wohnung eine energiesparende Fußbodenheizung. Betritt man die zur Vermietung stehende Wohnung befindet man sich zunächst im Flur, in dem sich auf der linken Seite die moderne und vollwertig ausgest..."
      },
      "has_ai_enrichment": true
    },
    {
      "id": "233Z8N1F5GAI",
      "cps": "233Z8N1F5GAI",
      "url": "https://www.immowelt.de/expose/1066aba8-b3c0-43ef-a688-1ce257f0ee11",
      "tags": {
        "is_new": true,
        "has3_d_visit": false,
        "is_exclusive": false,
        "has_brokerage_fee": false
      },
      "type": "PROFESSIONAL",
      "brand": "immowelt",
      "portal": "immowelt",
      "status": "Published",
      "display": "classified",
      "gallery": {
        "images": [
          {
            "alt": "Terrassenwohnung zur Miete 3 Zimmer 155 m² EG Sutthauser Straße 390 Sutthausen Osnabrück 49082",
            "key": "d2e596b3-13df-4137-8379-5295b8005fa8",
            "url": "https://mms.immowelt.de/d/2/e/5/d2e596b3-13df-4137-8379-5295b8005fa8.jpg?ci_seal=971e18d7fae913cc5c573c7e415817bf4e8394bc",
            "title": "Bild 1",
            "aria_label": "Bild 1",
            "description": "Bild 1"
          },
          {
            "key": "0555ee6c-9f66-47d0-b98c-9038fdb677f6",
            "url": "https://mms.immowelt.de/0/5/5/5/0555ee6c-9f66-47d0-b98c-9038fdb677f6.jpg?ci_seal=4df0f0645f7e28688d10eb5e84344e0e73bdf85c",
            "title": "Bild 2",
            "aria_label": "Bild 2",
            "description": "Bild 2",
            "classification": {
              "name": "HOUSE_FACADE",
              "version": "scene-classification-sagemaker-endpoint-live-1-3-10"
            }
          }
        ]
      },
      "location": {
        "address": {
          "city": "Osnabrück",
          "street": "Sutthauser Straße 390",
          "country": "DEU",
          "district": "Sutthausen",
          "zip_code": "49082"
        },
        "is_address_published": true
      },
      "metadata": {
        "id": "233Z8N1F5GAI",
        "status": {
          "status": true,
          "enrichments": {
            "geo": false,
            "media": false,
            "online_id": false,
            "intermediary": false,
            "contact_settings": false
          }
        },
        "legacy_id": "1066aba8-b3c0-43ef-a688-1ce257f0ee11",
        "update_date": "2026-06-01T20:02:24.937Z",
        "creation_date": "2014-01-19T16:18:06.623Z"
      },
      "provider": {
        "badge": {
          "title": "Diamond Partner",
          "image_url": "https://s.immowelt.org/shared/images/partner-badges/diamond-partner.svg"
        },
        "rating": {
          "link": "https://www.immowelt.de/profil/6d1a2b1c9ef247a2afb9097108bc979a#rating",
          "rating": 4.8,
          "reviews": 16
        },
        "address": "Hermann-Ehlers-Straße 3, 49082 Osnabrück",
        "imprint_url": "https://www.immowelt.de/profil/6d1a2b1c9ef247a2afb9097108bc979a#impressum",
        "profile_url": "https://www.immowelt.de/profil/6d1a2b1c9ef247a2afb9097108bc979a",
        "agency_strip": {
          "font_color": "#000000",
          "agency_color": "#ffffff"
        },
        "contact_card": {
          "title": "Herr Dipl.- Ing. W. Lintker",
          "display": true,
          "logo_url": null,
          "subtitle": "Dein Kontakt"
        },
        "display_links": true,
        "phone_numbers": [
          "1633364213"
        ],
        "publisher_type": "AGENCY",
        "is_private_owner": false,
        "intermediary_card": {
          "title": "Lintker Liegenschafts- & Immobiliendienst",
          "display": true,
          "logo_url": "https://mms.immowelt.de/5/2/9/d/529dc5ff-b44f-4503-a838-6ce358518fd4.jpg?ci_seal=1a1b1d05859c5defb5ca704143165cb1ca704295",
          "subtitle": "Gewerblicher Anbieter",
          "logo_href": "https://www.immowelt.de/profil/6d1a2b1c9ef247a2afb9097108bc979a"
        },
        "agency_legal_informations": []
      },
      "raw_data": {
        "nbroom": 3,
        "surface": {
          "main": 155,
          "plot": null
        },
        "providercity": "Osnabrück",
        "property_type": "APARTMENT",
        "providerzipcode": "49082",
        "geo_id_hierarchy": [
          {
            "id": "NBH2DE91298376",
            "type_key": "NBH2"
          },
          {
            "id": "AD08DE1864",
            "type_key": "AD08"
          },
          {
            "id": "AD06DE49",
            "type_key": "AD06"
          },
          {
            "id": "AD04DE3",
            "type_key": "AD04"
          },
          {
            "id": "AD02DE1",
            "type_key": "AD02"
          }
        ],
        "distribution_type": "RENT",
        "property_sub_type": "TERRACE",
        "offerer_marketing_key": "390 - 1",
        "contact_location_enabled": false
      },
      "tracking": {
        "id": "233Z8N1F5GAI",
        "city": "Osnabrück",
        "name": "classified",
        "region": "Lower Saxony",
        "country": "Germany",
        "currency": "EUR",
        "zip_code": "49082",
        "client_id": "62682",
        "legacy_id": "1066aba8-b3c0-43ef-a688-1ce257f0ee11",
        "list_name": "classified_detail_similars_bottom",
        "estate_type": "av_2",
        "product_type": "standard",
        "distribution_type": "1",
        "energy_certificate": "D"
      },
      "hard_facts": {
        "facts": [
          {
            "type": "numberOfRooms",
            "label": "Zimmer",
            "value": "3 Zimmer",
            "split_value": "3"
          },
          {
            "type": "livingSpace",
            "label": "m²",
            "value": "155 m²",
            "split_value": "155"
          },
          {
            "type": "numberOfFloors",
            "label": null,
            "value": "EG",
            "split_value": "EG"
          }
        ],
        "price": {
          "value": "Mietkosten auf Anfrage",
          "formatted": "Mietkosten auf Anfrage"
        },
        "title": "Terrassenwohnung zur Miete",
        "prices": [
          {
            "value": "Mietkosten auf Anfrage"
          }
        ],
        "keyfacts": [
          "3 Zimmer",
          "155 m²",
          "EG"
        ],
        "enriched_title": "Terrassenwohnung zur Miete - Seniorenimmobilie"
      },
      "energy_class": "D",
      "card_provider": {
        "title": "Herr Dipl.- Ing. W. Lintker",
        "logo_url": null,
        "subtitle": "Dein Kontakt",
        "agency_strip": {
          "font_color": "#000000",
          "agency_color": "#ffffff"
        }
      },
      "main_description": {
        "headline": "Repräsentative und außergewöhnliche Wohnung in Osnabrück",
        "metadata": {
          "language": "de"
        },
        "description": "Objektbeschreibung Das 2014 fertiggestellte Objekt befindet sich an der Sutthauser Straße, in direkter Nachbarschaft zum denkmalgeschützten Wulfter Turm im Stadtteil Sutthausen und verfügt über 4 repräsentative Wohneinheiten auf einem 2.500 m² großen Grundstück, welches an große zusammenhängende Wald- und Naherholungsgebiete angrenzt. Raumaufteilung Die repräsentative und seniorengerecht konzipierte Wohnung mit 155 m², die sich auf 3 Zimmer, Küche, Designbad mit begehbarer Dusche und Badewanne,..."
      },
      "has_ai_enrichment": true
    }
  ],
  "pagination": {
    "next": 2,
    "current": 1,
    "per_page": 30,
    "previous": null,
    "total_count": 59295,
    "total_pages": 1977,
    "has_next_page": true
  }
}
```

## Documentation

## Overview
Extract property listings from any Immowelt search results page. Returns structured listings with price, hard facts, gallery, location, provider info, and pagination metadata via website crawler.

## Quickstart
```
GET https://api.piloterr.com/v2/immowelt/search?query=https://www.immowelt.de/suche/mieten/wohnung/deutschland/ad02de1
```

Copy the full search URL from immowelt.de. Append `?page=2` to the URL for pagination.

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Full Immowelt search URL (pagination via `?page=` in the URL) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `results` | array | List of property listings |
| `results[].id` | string | Immowelt listing ID |
| `results[].url` | string | Property detail URL (`/expose/...`) |
| `results[].gallery` | object | Thumbnail images |
| `results[].location` | object | Address and geo data |
| `results[].hard_facts` | object | Price, rooms, area, property type |
| `results[].provider` | object | Agency or private seller info |
| `results[].tags` | object | Listing flags (new, exclusive, 3D visit, etc.) |
| `pagination.current` | integer | Current page number |
| `pagination.next` | integer \| null | Next page number |
| `pagination.previous` | integer \| null | Previous page number |
| `pagination.total_pages` | integer | Total pages |
| `pagination.total_count` | integer | Total matching listings |
| `pagination.per_page` | integer | Results per page |
| `pagination.has_next_page` | boolean | Whether a next page exists |

## Notes
- Response is returned under `results` with a `pagination` object.
- Only full Immowelt search URLs (`/suche/` or `/liste/`) are accepted as `query`.
- Append `?page=2` to the URL for pagination.
- Some cards may return partial nested data depending on listing type.
- Pass a property detail URL to the Immowelt Property endpoint for full listing data.

## Main use cases
- Monitor rental and sale inventory across German cities
- Build lead lists with price, specs, and agency attribution
- Feed property discovery pipelines for real estate analytics
- Track pagination across Immowelt search result pages