Recherchez des locations et des ventes sur ImmoScout24 Suisse. Passez un nom de ville ou une URL de recherche immoscout24.ch. Chaque annonce contient le prix en CHF, les pièces, la surface et l'adresse.
Les fiches bien ne sont pas disponibles. Une URL d'annonce comme https://www.immoscout24.ch/mieten/4002086198 renvoie 400. Cet endpoint concerne la Suisse.
Appartements à louer à Zurich. Une ville vaut rent et apartment par défaut.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=zurich&offer_type=rent
La même recherche via une URL enregistrée. Les filtres déjà dans l'URL sont conservés.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=https://www.immoscout24.ch/de/wohnung/mieten/ort-zuerich
Maisons à vendre à Genève. offer_type=buy met results[].offer_type à buy.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=geneve&offer_type=buy&property_type=house
Page 2. ImmoScout24 reçoit pn=2.
GET https://api.piloterr.com/v2/immoscout24ch/search?query=zurich&page=2
Chaîne obligatoire. Ville (zurich, geneve, bern, basel, luzern) ou URL de recherche. Une ville ouvre des appartements à louer : offer_type rent et price égal au loyer brut mensuel. Une URL d'annonce renvoie 400.
Chaîne facultative. Défaut rent pour une ville. buy (alias kaufen, sale) met offer_type à buy et price au prix de vente. Une URL de recherche garde son chemin tant que ce paramètre est vide.
Chaîne facultative. Défaut apartment pour une ville. house demande des maisons. all demande tous les types résidentiels. results[].categories reflète la catégorie.
Entier facultatif. Défaut 1. La page 2 envoie pn=2. pagination.next est l'URL suivante ou null.
Booléen facultatif. Défaut false. true renvoie le HTML brut.
| Champ |
Type |
Description |
results[].id |
string |
Id de l'annonce |
results[].url |
string |
URL de l'annonce |
results[].title |
string ou null |
Titre |
results[].offer_type |
string ou null |
rent ou buy |
results[].price |
number ou null |
Montant en CHF |
results[].price_display |
string ou null |
Même montant, par exemple CHF 2'257 |
results[].currency |
string ou null |
CHF |
results[].rooms |
number ou null |
Pièces |
results[].living_space |
number ou null |
Surface en m² |
results[].locality |
string ou null |
Ville |
results[].postal_code |
string ou null |
NPA |
results[].canton |
string ou null |
Canton |
pagination.next |
string ou null |
URL suivante, ou null |
price_display est reconstruit depuis price, avec une apostrophe comme séparateur de milliers, sans tiret final.
- Suivre les loyers à Zurich et à Genève
- Comparer des maisons à vendre depuis une URL enregistrée
- Paginer avec
page
| Code |
Signification |
| 400 |
Query manquante, type inconnu, ou URL d'annonce |
| 401 |
Clé API manquante |
| 404 |
Aucune annonce |
| 500 |
La page n'a pas pu être rendue |