# Immobilienscout24 Agent Scraper (`agenscrape/immobilienscout24-agent-scraper`) Actor

Extract real estate agent profiles from ImmobilienScout24. Get contact details, emails, phone numbers, company info, and property statistics. Fast & efficient scraping with structured data output ready for analysis or CRM integration.

- **URL**: https://apify.com/agenscrape/immobilienscout24-agent-scraper.md
- **Developed by:** [Agenscrape](https://apify.com/agenscrape) (community)
- **Categories:** Real estate
- **Features:** Limited permissions
- **Stats:** 30 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## ImmobilienScout24 Agent Scraper

Extract real estate agent profiles and contact information from ImmobilienScout24, Germany's leading real estate portal. Get comprehensive agent data including contact details, company information, and property statistics in seconds.

### 🎯 What This Actor Does

Automatically extracts detailed profiles of real estate agents from any location on ImmobilienScout24. Perfect for lead generation, market research, and business intelligence.

### ✨ Key Features

- **Complete Contact Information** - Email addresses, phone numbers, and full addresses
- **Company Details** - Business names, office locations, and imprint data
- **Property Statistics** - Total listings, rental vs. sales properties
- **Personal Information** - Agent names, descriptions, and profile photos
- **Fast & Reliable** - Efficient data extraction with automatic error handling
- **Structured Output** - Clean, ready-to-use data in multiple formats

### 📥 Input Configuration

Simply provide a search URL from ImmobilienScout24 and optionally limit the number of results:

```json
{
  "searchUrl": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen",
  "maxAgents": 50
}
```

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `searchUrl` | string | ✅ Yes | ImmobilienScout24 search URL for your target location |
| `maxAgents` | integer | ❌ No | Maximum number of agents to scrape (leave empty for all available) |

#### Finding Your Search URL

1. Go to [ImmobilienScout24](https://www.immobilienscout24.de/)
2. Search for properties in your target location (e.g., "Berlin", "München")
3. Copy the URL from your browser's address bar
4. Paste it into the `searchUrl` field

### 📤 Output Data

Each agent profile contains comprehensive information:

```json
{
  "agent_id": "12345678",
  "firstName": "Max",
  "lastName": "Mustermann",
  "email": "max.mustermann@realestate.de",
  "phoneNumber": "+49 30 12345678",
  "companyName": "Premium Real Estate GmbH",
  "description": "Experienced real estate agent specializing in Berlin properties...",
  "imageUrl": "https://...",
  "address_street": "Hauptstraße",
  "address_houseNumber": "123",
  "address_postcode": "10115",
  "address_city": "Berlin",
  "companyAddress_street": "Bürostraße",
  "companyAddress_postcode": "10115",
  "companyAddress_city": "Berlin",
  "stats_totalPropertiesCount": 45,
  "stats_rentPropertiesCount": 30,
  "stats_buyPropertiesCount": 15,
  "profileUrl": "https://www.immobilienscout24.de/..."
}
```

#### Available Fields

- **Contact Information**: email, phoneNumber, address details
- **Personal Data**: firstName, lastName, description, imageUrl
- **Company Information**: companyName, company address, imprint details
- **Statistics**: Total properties, rental properties, purchase properties
- **Reference**: agent_id, profileUrl

### 💼 Use Cases

#### Lead Generation

Build a comprehensive database of real estate agents for your sales pipeline. Export contacts with emails and phone numbers ready for outreach.

#### Market Research

Analyze the real estate market by location. Understand agent distribution, property availability, and market concentration.

#### Competitive Intelligence

Track competitor agents, their property portfolios, and market presence across different regions.

#### CRM Enhancement

Enrich your existing CRM data with up-to-date agent information, contact details, and property statistics.

#### Business Development

Identify potential partnerships or collaboration opportunities with agents in specific markets.

### 🚀 Getting Started

1. **Choose Your Location** - Navigate to ImmobilienScout24 and search for your target area
2. **Copy the URL** - Grab the search results URL from your browser
3. **Configure the Actor** - Paste the URL and set your desired agent limit
4. **Run & Download** - Start the actor and export results in your preferred format

### 📊 Export Formats

Download your data in multiple formats to suit your workflow:

- **JSON** - Perfect for developers and API integrations
- **CSV** - Import directly into Excel, Google Sheets, or databases
- **Excel (XLSX)** - Ready for business analysis and reporting
- **RSS** - Set up automated feed monitoring

### 💡 Pro Tips

- **Test First**: Start with `maxAgents: 10` to verify the data quality before running larger extractions
- **Location Specific**: Use detailed search URLs (city-level) for more targeted results
- **Regular Updates**: Run the actor periodically to keep your agent database fresh
- **Combine Data**: Use multiple location searches to build a comprehensive regional database

### 📋 Supported Locations

Works with all German cities and regions available on ImmobilienScout24:

- Major cities: Berlin, München, Hamburg, Frankfurt, Köln
- All other cities and towns across Germany
- State-level and district-level searches

### ⚡ Performance

- Processes **50 agents in under 2 minutes**
- Handles pagination automatically
- Built-in error handling for reliability
- Optimized for speed and accuracy

### 🎓 Example Workflows

#### Lead Generation Workflow

```
1. Search Berlin properties on ImmobilienScout24
2. Run actor with maxAgents: 100
3. Export to CSV
4. Import to your CRM or email marketing tool
5. Start outreach campaign
```

#### Market Analysis Workflow

```
1. Run actor for multiple cities (Berlin, München, Hamburg)
2. Export all results to Excel
3. Analyze agent distribution and property counts
4. Create market reports and visualizations
```

### ❓ Frequently Asked Questions

**Q: How many agents can I scrape?**
A: You can scrape all available agents for any search URL, or limit the results using the `maxAgents` parameter.

**Q: How often is the data updated?**
A: The actor fetches live data directly from ImmobilienScout24 every time you run it.

**Q: Can I scrape agents from multiple cities?**
A: Yes, simply run the actor multiple times with different search URLs for each location.

**Q: What if an agent doesn't have all information?**
A: The actor extracts all available data. Some fields may be empty if the agent hasn't provided that information.

***

Start extracting real estate agent data now and gain valuable insights into the German property market!

# Actor input Schema

## `searchUrl` (type: `string`):

ImmobilienScout24 search URL for the location you want to scrape agents from

## `maxAgents` (type: `integer`):

Maximum number of agent profiles to scrape (leave empty for all)

## Actor input object example

```json
{
  "searchUrl": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen",
  "maxAgents": 50
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchUrl": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen",
    "maxAgents": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("agenscrape/immobilienscout24-agent-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchUrl": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen",
    "maxAgents": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("agenscrape/immobilienscout24-agent-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchUrl": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen",
  "maxAgents": 50
}' |
apify call agenscrape/immobilienscout24-agent-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agenscrape/immobilienscout24-agent-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/I7PXfaqkcrAZEiiIw/builds/39sM08ns3RyjQDfKl/openapi.json
