Piloterr

Immowelt Search

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

Credit cost: 1 credit per call

GET
/v2/immowelt/search

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Full Immowelt search URL.

Example 1 (rental search):

https://www.immowelt.de/suche/mieten/wohnung/deutschland/ad02de1

Example 2 (legacy liste URL):

https://www.immowelt.de/liste/berlin/wohnungen/mieten

Example 3 (page 2):

https://www.immowelt.de/suche/mieten/wohnung/deutschland/ad02de1?page=2

Notes:

  • Supports /suche/ and /liste/ search URLs copied from immowelt.de.
  • Pagination via ?page=2 in the URL.
  • Use each result's url with the Immowelt Property endpoint for full listing data.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/immowelt/search?query=string"
{
  "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
  }
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}