ImmoScout24 Bot

Scrape listings, send contact requests, and manage messenger conversations on ImmoScout24 — fully automated via API.

Features

• Scrape listings — Search by URL, filter for private sellers only, extract full details (price, rooms, energy, descriptions, contact info).
• Apply to listings — Send contact requests with auto-filled profile data. Works for all contact form types.
• Send messages — Reply in existing messenger conversations.
• Get conversations — Retrieve all messenger conversations.
• Automatic 2FA — Handles email-based MFA via Gmail IMAP.
• Private seller detection — Filters by "von privat" badge, ohne-makler.net listings, and no-company indicators.

Setup

Prerequisites

1. An ImmoScout24 account with a complete profile (name, email, phone, address).
2. Fill out your Selbstauskunft on ImmoScout24.
3. If 2FA is enabled: a Gmail account with an App Password.

Modes

scrape

Search ImmoScout24 by pasting search URLs. Returns full listing details including price, rooms, area, energy certificate, descriptions, and contact information. Filter for private sellers only with onlyPrivate.

Input: searchUrls (array of IS24 search URLs), onlyPrivate, maxPages

apply

Send a contact request to a listing. Profile data (name, phone, address) is loaded automatically from your IS24 account. Verifies delivery by checking if a conversation was created.

Input: scoutId, message

send_message

Send a follow-up message in an existing conversation.

Input: conversationId or scoutId, message

get_conversations

Retrieve all messenger conversations. Optionally filter by scoutId.

Output Examples

Scrape

{
  "scoutId": "165686634",
  "title": "Einfamilienhaus in Hamburg-Niendorf",
  "isPrivate": true,
  "privateReason": "privateOffer badge",
  "contactName": "Mrs. X X",
  "contactPhones": ["+49 40 5296000"],
  "details": {"House type": "Bungalow", "Rooms": "3", "Construction year": "1944"},
  "finance": {"purchasePrice": {"value": 325000}, "brokerCommission": {"percentage": "3.57%"}},
  "descriptions": {"Property Description": "...", "Location": "..."}
}

Apply

{
  "success": true,
  "applied": true,
  "scoutId": "165686634",
  "conversationId": "6d6e4129-a242-4241-908d-d5cdb9761940",
  "timestamp": "2026-04-04T03:36:25Z"
}

Integration

Works with Zapier, Make, n8n, or any tool that can call the Apify API.