# Das Oertliche Scraper - German Business Directory (`studio-amba/dasoertliche-scraper`) Actor

Scrape the Das Oertliche (dasoertliche.de) directory for German businesses by trade and city. Get name, phone, e-mail, website, address, coordinates, category and opening hours.

- **URL**: https://apify.com/studio-amba/dasoertliche-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Das Oertliche Scraper

Pull business listings from Das Oertliche (dasoertliche.de), the German phone and business directory. The actor returns one row per listing with name, phone number, e-mail, website, address, coordinates, category and opening hours.

You choose a trade and a city, for example Zahnarzt in Hamburg, and get the listings of that trade in that city. The data suits lead lists, local market sizing, supplier checks and keeping a company database current.

### How to scrape dasoertliche.de data

There are two ways to choose listings.

1. Trades and cities. Fill `searchTerms` with trade words in German, for example `Zahnarzt`, `Elektriker`, `Restaurant` or `Rechtsanwalt`, and `cities` with German towns, for example `Hamburg`, `Köln` or `Frankfurt am Main`. Every trade is combined with every city. The actor reads the Das Oertliche list pages for each combination and returns the listings shown there.
2. Known listings. Fill `companyUrls` with listing pages from dasoertliche.de. The trades and cities are ignored in that case.

Set `maxResults` to the number of listings you want. One trade in one city has at most about 800 listings on dasoertliche.de, so use several cities or related trades for a larger list.

### Input

| Field | What it does |
|---|---|
| `searchTerms` | Trade words in German, as used on dasoertliche.de. |
| `cities` | German towns. Use the German spelling, for example Köln. |
| `companyUrls` | Listing pages from dasoertliche.de to read. |
| `includeDetails` | On by default. Opens every listing page to get e-mail, website, category and opening hours. Switch off for a faster run with name, phone, address and coordinates only. |
| `maxResults` | Maximum number of listings to return. |
| `proxyConfiguration` | Proxy used for the requests. Apify Proxy is the default. |

### What you get back

| Field | Content |
|---|---|
| `listingId` | Last part of the listing URL |
| `name` | Business name |
| `street`, `postalCode`, `city`, `region` | Address, with the federal state code in `region` |
| `latitude`, `longitude` | Coordinates of the listing |
| `phone` | Phone number as shown on the listing |
| `email` | E-mail address, when the business published one |
| `website` | Website, when the business published one |
| `category`, `categories` | Trades (Branchen) shown on the listing |
| `businessType` | Schema.org type of the listing, for example Restaurant |
| `openingHours` | Opening hours as one sentence, when published |
| `url` | Listing page on dasoertliche.de |
| `scrapedAt` | Time of the scrape |

Fields the business did not publish are `null`.

### Example output

```json
{
  "listingId": "First-Indian-Restaurant-Berlin-Charlottenburg-Wundtstrasse",
  "name": "First Indian Restaurant",
  "street": "Wundtstrasse 72",
  "postalCode": "14057",
  "city": "Berlin",
  "region": "BE",
  "latitude": 52.50709878414498,
  "longitude": 13.283877431217073,
  "phone": "0159 01 06 83 13",
  "email": "info@firstindianrestaurant.de",
  "website": "https://firstindianrestaurant.de",
  "category": "Gaststätten: Café-Restaurants",
  "categories": ["Gaststätten: Café-Restaurants"],
  "businessType": "LocalBusiness",
  "openingHours": "First Indian Restaurant hat montags bis sonntags von 11:00 - 23:00 Uhr geöffnet.",
  "url": "https://www.dasoertliche.de/Themen/First-Indian-Restaurant-Berlin-Charlottenburg-Wundtstrasse",
  "scrapedAt": "2026-11-18T15:02:10.297Z"
}
```

### Use cases

- Build a lead list of one trade across several German cities, with phone and e-mail.
- Check how many businesses of a trade operate in a city.
- Find the website of a business that is only known by name and address.
- Add listings to a second source when a business is missing from another German directory.
- Plot businesses on a map with the coordinates.

### Cost and speed

The actor uses plain HTTP requests and no browser, so runs are cheap. With `includeDetails` on, every listing costs one extra page request, which is where the e-mail and website come from. A run of 300 listings takes a few minutes. Pricing is per result, see the pricing box on this page. The usage cost of a run only settles after the run reports SUCCEEDED, so a cost checked during the run is too low.

### Notes and limits

- The trade word has to match a Branche on dasoertliche.de. If a word returns nothing, the run log says so. Try the singular form (Zahnarzt, not Zahnärzte) or a nearby word.
- Dasoertliche.de shows at most 29 list pages for one trade in one city, about 28 listings each.
- Only public listing and list pages are requested. The actor reads the same pages a visitor sees.
- The actor does not open the person search of the phone book. It returns business listings.
- Phone numbers are returned as published, so formats differ between listings.
- Please follow the data protection rules that apply to you when you use personal data of sole traders.

### Frequently asked questions

#### Can I search by business name?

Not in this version. Give a trade and a city, or paste the listing URLs you already have into `companyUrls`.

#### How do I find the right trade word?

Open dasoertliche.de, search for the trade and look at the Branche shown on the listings. Use that word, for example `Elektriker` or `Installateur`.

#### Why are some e-mail and website fields empty?

Businesses decide themselves whether to publish an e-mail address and a website. Listings without them return `null`.

#### How many listings can I get in one run?

One trade in one city gives at most about 800 listings. Add more cities or more trades to get more. `maxResults` limits the total.

#### What does `includeDetails` change?

With it on, every listing page is read and you get e-mail, website, category and opening hours. With it off, the run is faster and returns name, phone, address and coordinates from the list pages.

#### Does it work for Austria or Switzerland?

No. Das Oertliche covers Germany.

#### How often can I run it?

As often as you like. Schedule it in Apify to keep a list current.

### Related scrapers

- Telefonbuch Scraper for the Gelbe Seiten and Telefonbuch directory
- Firmenabc Scraper for Austrian companies
- Zlate stranky Scraper for Slovak companies

# Actor input Schema

## `searchTerms` (type: `array`):

Trade or category words as used on dasoertliche.de, in German, for example Zahnarzt, Elektriker, Restaurant or Rechtsanwalt. Each word is combined with each city.

## `cities` (type: `array`):

German towns, for example Hamburg, Muenchen or Frankfurt am Main. Use the German spelling, for example Köln.

## `companyUrls` (type: `array`):

Listing pages from dasoertliche.de, for example https://www.dasoertliche.de/Themen/First-Indian-Restaurant-Berlin-Charlottenburg-Wundtstrasse. When filled, trades and cities are ignored.

## `includeDetails` (type: `boolean`):

Open every listing page to get e-mail, website, category and opening hours. Switch off for a faster run with name, phone, address and coordinates only.

## `maxResults` (type: `integer`):

Maximum number of listings to return. One trade in one city has at most about 800 listings.

## `proxyConfiguration` (type: `object`):

Proxy used for the requests. Default is Apify Proxy.

## Actor input object example

```json
{
  "searchTerms": [
    "Zahnarzt"
  ],
  "cities": [
    "Hamburg"
  ],
  "includeDetails": true,
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "searchTerms": [
        "Zahnarzt"
    ],
    "cities": [
        "Hamburg"
    ],
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/dasoertliche-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 = {
    "searchTerms": ["Zahnarzt"],
    "cities": ["Hamburg"],
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/dasoertliche-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 '{
  "searchTerms": [
    "Zahnarzt"
  ],
  "cities": [
    "Hamburg"
  ],
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/dasoertliche-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/dasoertliche-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/buCCN0skXrL7D7rkj/builds/LfcpdGGc9t8HugaGq/openapi.json
