# 11880.com Scraper - German Business Directory (`crawlerbros/11880-scraper`) Actor Scrape 11880.com (Germany's business directory) listings. Search by category and city, or fetch full business profiles by URL. Get names, addresses, phone numbers, ratings, opening hours, websites, and more. - **URL**: https://apify.com/crawlerbros/11880-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Lead generation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 11880.com Scraper - German Business Directory Scrape **11880.com** — one of Germany's leading business directories (run by 11880 Solutions AG, formerly klicktel). Search any business category in any German city, town, or postal code and get names, addresses, phone numbers, ratings, opening status, categories, and more. Optionally follow through to each business's full profile page for the website URL, fax number, precise GPS coordinates, complete weekly opening hours, services, social links, and customer reviews. No login, no cookies, no API key required. ### What this actor does - **Two modes:** `search` (category + city) and `detail` (direct business profile URLs) - **45+ curated categories** to pick from, or type any custom category - **Filter by** "open now", minimum star rating (1-5), "has at least one rating", or "exclude premium/sponsored listings" - **Full German character support** — ä, ö, ü, ß are handled correctly; 11880.com auto-normalizes umlauts in city/category names - **Rich business profiles** — website, fax, GPS coordinates, structured weekly opening hours, services, social media links, and individual customer reviews - **Empty fields are omitted** — you only ever see fields that were actually found for a business ### Output per business - `name` — business name - `category` — the business's primary listed category (mode=search) - `services[]` — listed services/offerings ("Leistungen"), when profile fetched - `rating`, `reviewCount` — average star rating (1-5) and number of reviews - `street`, `zipCode`, `city`, `state`, `district` - `latitude`, `longitude` — precise GPS coordinates (when profile fetched) - `isOpenNow`, `openingHoursStatusText` — live open/closed status from the search listing - `openingHours[]` — full structured weekly hours (`{day, opens, closes}` per day; when profile fetched) - `openingHoursInfo` — free-text scheduling note (e.g. "Termine nach Vereinbarung"), when profile fetched - `phone`, `fax`, `email`, `website`, `imageUrl`, `logoUrl` - `images[]` — photo gallery (when profile fetched) - `socialLinks[]` — the business's own social media profiles (`{platform, url}`, when profile fetched) - `reviews[]` — individual customer reviews (`{author, date, rating, text}`, when profile fetched) - `priceRange` — price indicator (e.g. "€€"), when published - `isPremium`, `premiumTier`, `isOwnerConfirmed` — listing badges (mode=search) - `businessId` — 11880.com's internal business identifier - `searchCategory`, `searchCity` — the category/city you searched for (mode=search) - `sourceUrl` — canonical 11880.com profile URL for the business - `recordType: "business"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `mode` | string | `search` | `search` (category + city) or `detail` (fetch by URL) | | `category` | string (select) | `Friseur` | Pick a common category, or `custom` to use `customCategory` (mode=search) | | `customCategory` | string | – | Any free-text category, overrides `category` (mode=search) | | `city` | string | `Berlin` | City, town, or postal code to search in (mode=search) | | `openNowOnly` | boolean | `false` | Only return businesses currently open | | `ratedOnly` | boolean | `false` | Only return businesses that have at least one rating (ignored when `minRating` is set) | | `minRating` | string (select) | – (no minimum) | Only return businesses rated at least `1`-`5` stars | | `excludePremiumListings` | boolean | `false` | Skip paid/sponsored ("SILBER"/"GOLD") listings; organic results only | | `fetchDetails` | boolean | `false` | Also visit each business's profile page for richer data (slower) | | `businessUrls` | array | – | 11880.com profile URLs to fetch directly (mode=detail) | | `maxItems` | int | `50` | Hard cap on returned records (1-1000) | #### Example: search hairdressers in Berlin ```json { "mode": "search", "category": "Friseur", "city": "Berlin", "maxItems": 50 } ```` #### Example: rated restaurants in Munich, with full profiles ```json { "mode": "search", "customCategory": "Restaurant", "city": "München", "fetchDetails": true, "ratedOnly": true, "maxItems": 30 } ``` #### Example: lawyers open right now in Cologne ```json { "mode": "search", "category": "Rechtsanwalt", "city": "Köln", "openNowOnly": true, "maxItems": 100 } ``` #### Example: 4+ star electricians in Hamburg, with full profiles (website, fax, hours, reviews) ```json { "mode": "search", "category": "Elektriker", "city": "Hamburg", "minRating": "4", "fetchDetails": true, "maxItems": 40 } ``` #### Example: fetch specific business profiles ```json { "mode": "detail", "businessUrls": [ { "url": "https://www.11880.com/branchenbuch/berlin/110631771B53153259/farkas-manthei-gbr.html" } ] } ``` ### Use cases - **Local lead generation** — build a prospect list of businesses by trade and city for B2B outreach - **Market research** — measure business density and average ratings for a category across German cities - **Directory aggregation** — feed structured German business data into your own local-search product - **Competitor mapping** — see who else operates in a category and area, with ratings and contact info - **Reputation monitoring** — pull individual customer reviews per business (with `fetchDetails: true`) ### Limitations - **Sort order** is controlled client-side by 11880.com's JavaScript UI (Standard / Bewertung / Entfernung) and is not exposed via a stable URL parameter; results are returned in the site's own default relevance order. - Some fields (`website`, `fax`, full `openingHours`, `services`, `socialLinks`, `images`, `reviews`) are only available on the business's full profile page — enable `fetchDetails` in search mode, or use `detail` mode directly, to populate them. ### FAQ **What data source does this actor use?** It reads the publicly available search and business-profile pages on 11880.com, a leading German business directory (11880 Solutions AG). No account or API key is needed. **Is this affiliated with 11880.com?** No. This is an independent, third-party actor that reads publicly accessible pages. **Why do some businesses have no rating, phone, or website?** 11880.com only shows a rating once a business has received at least one review, and only shows contact details a business itself provided. Fields with no data are simply omitted from the record rather than shown as empty or null. **Can I search by postal code instead of a city name?** Yes — the `city` field accepts German postal codes as well as city/town names. **What happens if I type a city or category with umlauts?** 11880.com normalizes umlauts and casing automatically (e.g. "München" and "Munchen" both resolve to the same results), so you can type city and category names naturally. **How accurate are the GPS coordinates?** `latitude`/`longitude` come directly from the business's own 11880.com profile page (only available with `fetchDetails: true` in search mode, or always in `detail` mode). **Why is `fetchDetails` off by default?** Fetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need the website, fax number, coordinates, full weekly opening hours, services, social links, or reviews. **How does `minRating` differ from `ratedOnly`?** `ratedOnly` returns any business with at least one review (any star rating). `minRating` excludes businesses rated *below* the chosen number of stars, but — like `ratedOnly` — does not by itself exclude businesses with no rating at all (an absent field is treated as "not disqualified" rather than "fails the check"). Combine `minRating` with `ratedOnly: true` to get only businesses rated at or above your threshold with no unrated results mixed in. **Why does `openNowOnly` sometimes return businesses with no visible open/closed status?** 11880.com only shows a live open/closed badge for categories where it makes sense (e.g. hairdressers, restaurants). Professional-services categories like lawyers or notaries often don't display one at all — since there's no status to check, those listings aren't excluded by `openNowOnly` (same "absent field passes through" convention used by `minRating`). **What are `isPremium`/`premiumTier`?** 11880.com sells premium/sponsored listing placements (shown at the top of search results, badged "SILBER"/"GOLD"/etc.). These fields let you distinguish paid placements from organic listings. # Actor input Schema ## `mode` (type: `string`): What to fetch: search a category + city, or fetch full business profiles from direct URLs. ## `category` (type: `string`): Business category to search for. Pick a common category from the list, or choose 'Custom category' and type your own in the field below (mode=search). ## `customCategory` (type: `string`): Free-text category not in the curated list above, e.g. 'Fensterreinigung' or 'Yoga-Studio' (mode=search). Takes priority over 'Category' when set. ## `city` (type: `string`): German city, town, or postal code to search in, e.g. 'Berlin', 'München', 'Köln', 'Hamburg' (mode=search). Umlauts are handled automatically. ## `openNowOnly` (type: `boolean`): Only return businesses that are currently open (mode=search). Businesses whose listing doesn't show a live open/closed status (common for professional-services categories like lawyers or notaries) are not excluded by this filter, since 11880.com doesn't publish a status to check. ## `ratedOnly` (type: `boolean`): Only return businesses that have at least one customer rating (mode=search). Ignored when 'Minimum rating' below is set. ## `excludePremiumListings` (type: `boolean`): Skip businesses that paid for a premium/sponsored placement (badged 'SILBER', 'GOLD', etc. at the top of search results), returning only organic listings (mode=search). ## `minRating` (type: `string`): Excludes businesses rated below this many stars, e.g. '4' excludes anything under 4.0 (mode=search). Businesses with no rating at all are not excluded by this filter alone -- also enable 'Only businesses with ratings' to exclude those too. ## `fetchDetails` (type: `boolean`): For each search result, also visit its business profile page to collect the website URL, fax number, precise coordinates, full weekly opening hours, services, social links, and reviews. Slower (mode=search). ## `businessUrls` (type: `array`): Direct 11880.com business profile URLs to fetch, e.g. https://www.11880.com/branchenbuch///.html. Use the 'sourceUrl' field from search results. ## `maxItems` (type: `integer`): Hard cap on the number of business records to return. ## Actor input object example ```json { "mode": "search", "category": "Friseur", "city": "Berlin", "openNowOnly": false, "ratedOnly": false, "excludePremiumListings": false, "minRating": "", "fetchDetails": false, "businessUrls": [], "maxItems": 50 } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped 11880.com business listings. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "category": "Friseur", "city": "Berlin", "openNowOnly": false, "ratedOnly": false, "excludePremiumListings": false, "minRating": "", "fetchDetails": false, "businessUrls": [], "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/11880-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "category": "Friseur", "city": "Berlin", "openNowOnly": False, "ratedOnly": False, "excludePremiumListings": False, "minRating": "", "fetchDetails": False, "businessUrls": [], "maxItems": 50, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/11880-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "category": "Friseur", "city": "Berlin", "openNowOnly": false, "ratedOnly": false, "excludePremiumListings": false, "minRating": "", "fetchDetails": false, "businessUrls": [], "maxItems": 50 }' | apify call crawlerbros/11880-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/11880-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "11880.com Scraper - German Business Directory", "description": "Scrape 11880.com (Germany's business directory) listings. Search by category and city, or fetch full business profiles by URL. Get names, addresses, phone numbers, ratings, opening hours, websites, and more.", "version": "1.0", "x-build-id": "0xYSO8fqVH9wTee89" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~11880-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-11880-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~11880-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-11880-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~11880-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-11880-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "detail" ], "type": "string", "description": "What to fetch: search a category + city, or fetch full business profiles from direct URLs.", "default": "search" }, "category": { "title": "Category", "enum": [ "custom", "Friseur", "Restaurant", "Rechtsanwalt", "Zahnarzt", "Arzt", "Allgemeinarzt", "Handwerker", "Hotel", "Elektriker", "Dachdecker", "Maler", "Steuerberater", "Immobilienmakler", "Gartenbau", "Bestatter", "Physiotherapie", "Tierarzt", "Apotheke", "Optiker", "Fahrschule", "Kfz-Werkstatt", "Gebäudereinigung", "Umzugsunternehmen", "Bäckerei", "Metzgerei", "Kosmetikstudio", "Massage", "Fitnessstudio", "Sanitär", "Heizung", "Schreiner", "Fensterbau", "Kanalreinigung", "Rohrreinigung", "Schädlingsbekämpfung", "Logopädie", "Bauunternehmen", "Notar", "Architekt", "Versicherungsmakler", "Nachhilfe", "Friedhofsgärtner", "Reisebüro", "Autohaus", "Bank", "Apotheker" ], "type": "string", "description": "Business category to search for. Pick a common category from the list, or choose 'Custom category' and type your own in the field below (mode=search).", "default": "Friseur" }, "customCategory": { "title": "Custom category (overrides selection above)", "type": "string", "description": "Free-text category not in the curated list above, e.g. 'Fensterreinigung' or 'Yoga-Studio' (mode=search). Takes priority over 'Category' when set." }, "city": { "title": "City / location", "type": "string", "description": "German city, town, or postal code to search in, e.g. 'Berlin', 'München', 'Köln', 'Hamburg' (mode=search). Umlauts are handled automatically.", "default": "Berlin" }, "openNowOnly": { "title": "Open now only", "type": "boolean", "description": "Only return businesses that are currently open (mode=search). Businesses whose listing doesn't show a live open/closed status (common for professional-services categories like lawyers or notaries) are not excluded by this filter, since 11880.com doesn't publish a status to check.", "default": false }, "ratedOnly": { "title": "Only businesses with ratings", "type": "boolean", "description": "Only return businesses that have at least one customer rating (mode=search). Ignored when 'Minimum rating' below is set.", "default": false }, "excludePremiumListings": { "title": "Exclude premium/sponsored listings", "type": "boolean", "description": "Skip businesses that paid for a premium/sponsored placement (badged 'SILBER', 'GOLD', etc. at the top of search results), returning only organic listings (mode=search).", "default": false }, "minRating": { "title": "Minimum rating", "enum": [ "", "1", "2", "3", "4", "5" ], "type": "string", "description": "Excludes businesses rated below this many stars, e.g. '4' excludes anything under 4.0 (mode=search). Businesses with no rating at all are not excluded by this filter alone -- also enable 'Only businesses with ratings' to exclude those too.", "default": "" }, "fetchDetails": { "title": "Fetch full business profiles", "type": "boolean", "description": "For each search result, also visit its business profile page to collect the website URL, fax number, precise coordinates, full weekly opening hours, services, social links, and reviews. Slower (mode=search).", "default": false }, "businessUrls": { "title": "Business profile URLs (mode=detail)", "type": "array", "description": "Direct 11880.com business profile URLs to fetch, e.g. https://www.11880.com/branchenbuch///.html. Use the 'sourceUrl' field from search results.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "11880.com business profile URL." } } }, "default": [] }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of business records to return.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```