# 11880 Local Business Directory Scraper (`automation-lab/11880-local-business-directory-scraper`) Actor Extract German 11880.com business leads with contact details, ratings, websites, opening hours, and source search context. - **URL**: https://apify.com/automation-lab/11880-local-business-directory-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Local Business Directory Scraper Export German local business leads from 11880.com search and profile pages. The actor collects business names, categories, addresses, phone numbers, emails, websites, ratings, review counts, opening hours, coordinates, and source search metadata when those fields are publicly visible. ### What This Actor Does 11880.com is a German local business directory with category and city search pages for restaurants, trades, health providers, shops, services, and other local companies. This actor turns those public directory pages into structured records you can use for lead research, local market mapping, enrichment, and prospect list building. ### Best Use Cases Use it when you need German business records by keyword and location. Common examples include restaurant lists in Berlin, dentists in Hamburg, roofers in Munich, plumbers in Cologne, or any other 11880 category/location combination. ### Who Is It For Sales teams use it for local prospect discovery. Agencies use it for regional market research. Recruiters and partnership teams use it to identify local service providers. Analysts use it to compare density, ratings, and contact availability across cities. ### Why Use 11880 Data 11880 is focused on Germany and includes many business profiles with phone, email, address, ratings, and opening-hour information. For German local lead generation, this can be more targeted than broad web search because each row is already a business directory entity. ### Input Overview You can search by `searchTerm` and `location`, or provide direct `startUrls`. If both are present, `startUrls` take priority. Search URLs and profile URLs are both supported. ### Search Input Set `searchTerm` to a business category or keyword. Set `location` to a German city, district, or region. Example: `restaurant` and `berlin`. ### Start URLs Use `startUrls` when you already have a specific 11880 search result page or profile page. Supported examples: `https://www.11880.com/suche/restaurant/berlin` `https://www.11880.com/branchenbuch/berlin/071364395B107275402/babu-restaurant.html` ### Result Limits Use `maxResults` to cap the number of businesses saved. Small test runs should use 5 to 20 results. Larger production runs can raise the limit after you verify the input. ### Profile Details Enable `scrapeProfileDetails` to open each profile page. This adds website, coordinates, opening hours, payment methods, and richer category text where available. Disable it when you only need fast search-page exports. ### Output Fields The dataset can include: `businessName` `category` `profileUrl` `website` `email` `phone` `streetAddress` `postalCode` `city` `region` `latitude` `longitude` `rating` `reviewCount` `openingHours` `priceRange` `paymentAccepted` `image` `sourceSearchTerm` `sourceLocation` `sourceUrl` ### Example Input ```json { "searchTerm": "restaurant", "location": "berlin", "maxResults": 20, "scrapeProfileDetails": true } ```` ### Example Output ```json { "businessName": "BABU Restaurant", "category": "Restaurant, Indisches Restaurant & Halal-Essen", "profileUrl": "https://www.11880.com/branchenbuch/berlin/071364395B107275402/babu-restaurant.html", "website": "http://www.babu-restaurant.com/", "email": "visit@babu-restaurant.com", "phone": "(030) 46994966", "streetAddress": "Treptower Str. 95", "postalCode": "12059", "city": "Berlin", "region": "Berlin", "rating": 5, "reviewCount": 1, "sourceSearchTerm": "restaurant", "sourceLocation": "berlin" } ``` ### How Pagination Works 11880 search pages expose page navigation through `?page=N`. The actor follows those pages until it reaches `maxResults` or stops finding new business records. Duplicate profile URLs are skipped automatically. ### Data Quality The actor reads schema.org JSON-LD first because it is the most structured public representation on 11880 pages. Profile pages are used to enrich records where 11880 exposes more detail than the search page. Fields that are not visible on a page are omitted instead of guessed. ### Website Extraction Website links are collected from profile pages where available. Some profiles do not publish a website, and those records will have an empty `website` field. ### Email Extraction Search and profile JSON-LD often expose business email addresses. The actor saves email values only when the page exposes them directly. ### Ratings Ratings and review counts are extracted from 11880 aggregate rating metadata when present. Unrated businesses can still be returned with contact and address fields. ### Opening Hours Opening hours are collected from profile-page JSON-LD when `scrapeProfileDetails` is enabled. The field is stored as a readable semicolon-separated string. ### Pricing #### How much does it cost to scrape 11880 business leads? The actor uses Apify pay-per-event billing: - Run start event: $0.005 per run - Result event: $0.000115 per result (FREE) / $0.000100 per result (BRONZE) / $0.000078 per result (SILVER) / $0.00006 per result (GOLD) / $0.00004 per result (PLATINUM) / $0.000028 per result (DIAMOND) Example cost estimate: 1. 20 results on FREE: `20 x $0.000115 + $0.005` = `$0.0073` 2. 100 results on BRONZE: `100 x $0.0001 + $0.005` = `$0.015` 3. 1000 results on SILVER: `1000 x $0.000078 + $0.005` = `$0.083` Your exact per-result rate depends on your platform quota tier.\ For a free-tier estimate, use the FREE rate above. ### How to run this actor 1. Open the Apify Store page: `https://apify.com/automation-lab/11880-local-business-directory-scraper` 2. Click **Run** and confirm you are signed in. 3. In **Input**, paste your JSON configuration or build it using the form controls. 4. Start with a small `maxResults` value (for example `20`) and verify output quality. 5. Raise `maxResults` and enable `scrapeProfileDetails` only when you need the extra enrichment fields. 6. Export the resulting dataset as JSON, CSV, or Excel from the run page. Tip: Keep `maxResults` low on your first run if this is a new city/keyword combination. ### Performance Tips Start with a small `maxResults` value to confirm the search term and city produce the businesses you expect. Disable `scrapeProfileDetails` when you need faster, lower-request search exports. Enable profile details when you need websites, coordinates, opening hours, and payment metadata. ### Integrations Export the dataset as JSON, CSV, Excel, XML, or RSS through Apify dataset exports. Use the Apify API to run the actor from CRMs, enrichment workflows, notebooks, or scheduled data pipelines. ### API Usage You can call the actor with a JSON input body containing `searchTerm`, `location`, `maxResults`, and `scrapeProfileDetails`. Use direct `startUrls` when your workflow already stores 11880 URLs. Node.js example: ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/11880-local-business-directory-scraper').call({ searchTerm: 'restaurant', location: 'berlin', maxResults: 20, scrapeProfileDetails: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` Python example: ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ["APIFY_TOKEN"]) run = client.actor("automation-lab/11880-local-business-directory-scraper").call( run_input={ "searchTerm": "restaurant", "location": "berlin", "maxResults": 20, "scrapeProfileDetails": True, } ) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` cURL example: ```bash curl "https://api.apify.com/v2/acts/automation-lab~11880-local-business-directory-scraper/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchTerm":"restaurant","location":"berlin","maxResults":20,"scrapeProfileDetails":true}' ``` ### MCP Usage Use Apify MCP via HTTP for this actor. 1. Register the tool endpoint in Claude: ```bash claude mcp add --transport http apify https://mcp.apify.com?tools=automation-lab/11880-local-business-directory-scraper ``` 2. Desktop/Cursor MCP JSON config (example): ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=automation-lab/11880-local-business-directory-scraper" } } } ``` 3. VS Code MCP JSON config (example): ```json { "inputs": [ { "type": "mcp_server", "id": "apify", "params": { "url": "https://mcp.apify.com?tools=automation-lab/11880-local-business-directory-scraper" } } ] } ``` Example prompts: - `Run 11880 Local Business Directory Scraper for restaurants in Berlin and return 20 results.` - `Find dentists in Hamburg with scrapeProfileDetails enabled.` - `Return email, phone, website, and opening hours for this 11880 profile: https://www.11880.com/...` ### Legality This actor extracts publicly available information from 11880.com pages. You are responsible for using exported data in compliance with applicable laws, platform terms, and privacy regulations. ### FAQ Can I scrape a direct profile URL? Yes. Add a 11880 profile URL to `startUrls`. Can I skip profile pages? Yes. Set `scrapeProfileDetails` to `false` for faster search-page exports. Why are some websites or emails missing? 11880 profiles vary. The actor only saves contact fields that are publicly visible in the page metadata or profile HTML. ### Troubleshooting If a run returns fewer records than expected, check whether the 11880 search page itself contains enough results. If website fields are missing, keep `scrapeProfileDetails` enabled and confirm the profile publishes an external website link. If a direct URL fails, make sure it is a public 11880 search or profile URL. ### Related Actors - https://apify.com/automation-lab/gelbeseiten-scraper - https://apify.com/automation-lab/paginegialle-scraper - https://apify.com/automation-lab/cylex-scraper ### Changelog Initial version: HTTP/Cheerio scraper for 11880 search and profile pages. # Actor input Schema ## `searchTerm` (type: `string`): Business category, trade, or keyword to search on 11880.com. ## `location` (type: `string`): German city, district, or region to search. ## `startUrls` (type: `array`): Optional direct 11880 search result or profile URLs. Search URLs can include page parameters. ## `maxResults` (type: `integer`): Maximum number of business records to save. ## `scrapeProfileDetails` (type: `boolean`): Open each business profile to collect website, coordinates, opening hours, payment methods, and richer category text where available. ## `maxRequestRetries` (type: `integer`): Number of retry attempts for failed HTTP requests. ## Actor input object example ```json { "searchTerm": "restaurant", "location": "berlin", "startUrls": [ { "url": "https://www.11880.com/suche/restaurant/berlin" } ], "maxResults": 20, "scrapeProfileDetails": true, "maxRequestRetries": 3 } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerm": "restaurant", "location": "berlin", "startUrls": [ { "url": "https://www.11880.com/suche/restaurant/berlin" } ], "maxResults": 20, "scrapeProfileDetails": true, "maxRequestRetries": 3 }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/11880-local-business-directory-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 = { "searchTerm": "restaurant", "location": "berlin", "startUrls": [{ "url": "https://www.11880.com/suche/restaurant/berlin" }], "maxResults": 20, "scrapeProfileDetails": True, "maxRequestRetries": 3, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/11880-local-business-directory-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 '{ "searchTerm": "restaurant", "location": "berlin", "startUrls": [ { "url": "https://www.11880.com/suche/restaurant/berlin" } ], "maxResults": 20, "scrapeProfileDetails": true, "maxRequestRetries": 3 }' | apify call automation-lab/11880-local-business-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/11880-local-business-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "11880 Local Business Directory Scraper", "description": "Extract German 11880.com business leads with contact details, ratings, websites, opening hours, and source search context.", "version": "0.1", "x-build-id": "mV7bgnGfSCSxwyOLk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~11880-local-business-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-11880-local-business-directory-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/automation-lab~11880-local-business-directory-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-11880-local-business-directory-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/automation-lab~11880-local-business-directory-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-11880-local-business-directory-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", "properties": { "searchTerm": { "title": "Search term", "type": "string", "description": "Business category, trade, or keyword to search on 11880.com." }, "location": { "title": "Location", "type": "string", "description": "German city, district, or region to search." }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional direct 11880 search result or profile URLs. Search URLs can include page parameters.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of business records to save.", "default": 50 }, "scrapeProfileDetails": { "title": "Scrape profile details", "type": "boolean", "description": "Open each business profile to collect website, coordinates, opening hours, payment methods, and richer category text where available.", "default": true }, "maxRequestRetries": { "title": "Max request retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of retry attempts for failed HTTP requests.", "default": 3 } } }, "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 } } } } } } } } } } ```