Aller au contenu principal
Piloterr
Retour à la bibliothèque

API ImmoScout24 Switzerland Search

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.

Actif2 crédits = 1 requêteGET/v2/immoscout24ch/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Vue d'ensembleLink to Vue d'ensemble

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.

Démarrage rapideLink to Démarrage rapide

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

ParamètresLink to Paramètres

queryLink to query

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.

offer_typeLink to offer_type

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.

property_typeLink to property_type

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.

pageLink to page

Entier facultatif. Défaut 1. La page 2 envoie pn=2. pagination.next est l'URL suivante ou null.

return_page_sourceLink to return_page_source

Booléen facultatif. Défaut false. true renvoie le HTML brut.

Champs de réponseLink to Champs de réponse

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

NotesLink to Notes

price_display est reconstruit depuis price, avec une apostrophe comme séparateur de milliers, sans tiret final.

Cas d'usageLink to Cas d'usage

  • Suivre les loyers à Zurich et à Genève
  • Comparer des maisons à vendre depuis une URL enregistrée
  • Paginer avec page

Codes d'erreurLink to Codes d'erreur

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

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus