Gelbe Seiten Business Scraper
Pricing
from $2.40 / 1,000 business founds
Gelbe Seiten Business Scraper
Gelbe Seiten business scraper with email, phone, website, GPS coordinates, ratings and opening hours. Search by business type and city or postal code.
Pricing
from $2.40 / 1,000 business founds
Rating
0.0
(0)
Developer
Khadin Akbar
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
9 hours ago
Last modified
Categories
Features
Share
What is Gelbe Seiten Business Scraper?
Gelbe Seiten Business Scraper turns a business type and a German city, district or postal code into a clean list of public business records from Gelbe Seiten, the German yellow pages. Each row is one unique business with its name, categories, address, GPS coordinates, phone, email, website, rating, review count and opening hours by weekday, plus the original page URL so every record can be checked at the source.
In a measured 45-business run for dentists in Berlin, 89% of rows had an email, 84% a website, 100% a phone number and 100% GPS coordinates. Results depend on what each business publishes, so empty fields are returned as null and never invented.
What's new
- GPS
latitudeandlongitudefor every business that publishes them, ready for maps and territory planning. openingHoursStructured: opening hours as weekday codes with time ranges, ready to filter or import.categoriesandfaxfrom each business page.sortBy: order a search by best match or by highest rating first.- Faster large runs: runs above 30 businesses fetch business pages in parallel. A 45-business test finished in 21 seconds, down from 32 seconds.
- Lower prices with plan discounts, and Apify platform usage is included in the event price.
What you can do with it
- Build a territory list of every steuerberater, zahnarzt or handwerker in a city, then plot it by coordinates.
- Rank competitors in a district by rating and review count.
- Fill a CRM with phone, email and website for German B2B outreach, keeping the source URL on each record.
- Give an AI agent a dependable German local-business lookup with a fixed row cap.
Quick start
{"searches": [{ "query": "Zahnarzt", "location": "Berlin" }],"maxResults": 50,"sortBy": "rating","enrichDetails": true}
Set enrichDetails to false for the fastest list-card output. GPS, categories, fax and structured opening hours come from business pages, so they need enrichDetails on.
Input
| Field | Type | What it controls |
|---|---|---|
searches | array | One or more { query, location } pairs, such as Zahnarzt and Berlin. Location accepts a city, district or postal code. |
startUrls | array | Existing Gelbe Seiten search or business URLs. Search URLs keep their public filters. |
maxResults | integer | 1 to 500 unique businesses across all inputs. This is also the cap on billable results. Free-plan runs return up to 50. |
sortBy | string | relevance (best match, default) or rating (highest rated first). Applies to searches. |
enrichDetails | boolean | Visit each business page for GPS, categories, fax, structured hours and any missing email or website. |
Output
Example row from a real run (some fields shortened):
{"businessName": "KU64 Dr. Ziegler & Partner","primaryCategory": "Zahnärzte","address": "Kurfürstendamm 64, 10707 Berlin (Charlottenburg)","postalCode": "10707","city": "Berlin","phone": "030 8 64 73 20","email": "info@ku64.de","website": "https://ku64.de","rating": 3.7,"reviewCount": 51,"latitude": 52.50063,"longitude": 13.310329,"openingHoursStructured": { "Mo": ["08:00-20:00"], "Sa": ["09:00-19:00"] },"detailPageUrl": "https://www.gelbeseiten.de/gsbiz/ccbb2551-abd0-4504-8981-48cd45183d19","scrapedAt": "2026-11-16T10:37:54.071Z"}
Every run also writes two records to the key-value store. OUTPUT holds the outcome (COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT or UPSTREAM_FAILED), counts and warnings. It includes an agentSummary with the share of rows that have email, website, phone, coordinates and hours. RUN_SUMMARY holds detailed counts for the run.
How much does it cost?
You pay per business found, with discounts on Bronze, Silver and Gold Apify plans, plus a tiny start fee. Apify platform usage is included, so the event price is the whole bill.
| Run size | Charged events |
|---|---|
| 50 businesses | 50 business events and 1 start event |
| 200 businesses | 200 business events and 1 start event |
| 500 businesses | 500 business events and 1 start event |
Duplicate listings and records that fail validation are never charged. Set a maximum cost per run in Apify to cap spend; the run stops cleanly when the cap is reached. Open the Pricing tab for the current price of each event on your plan.
Use through the API
curl "https://api.apify.com/v2/acts/khadinakbar~gelbe-seiten-scraper/runs?token=$APIFY_TOKEN" \-H "Content-Type: application/json" \-d '{"searches":[{"query":"Steuerberater","location":"Hamburg"}],"maxResults":25,"sortBy":"rating"}'
After the run finishes, read the default dataset and the OUTPUT record. Keep detailPageUrl with each downstream record.
AI agents through Apify MCP
Use the Gelbe Seiten Business Scraper to find the 25 best-rated Steuerberater in Hamburg. Return name, address, phone, website, rating and coordinates. Read OUTPUT.agentSummary first and keep the source URL for each business.
The Actor is ready for agent use: a fixed row cap, an honest outcome code, and a one-glance agentSummary that tells the agent what share of rows carry each contact field.
More tools that work well with this one
| Actor | Why pair it |
|---|---|
| Google Maps Leads Scraper | Add Google Maps businesses to the same territory list. |
| Bulk Website Contact Extractor | Pull more contacts from the websites found here. |
| Email Address Validator | Check the emails before outreach. |
| Universal Lead Finder | Search any niche and city beyond Germany. |
FAQ
Which cities and categories work? Any German city, district or postal code, and any business type that Gelbe Seiten lists, for example Zahnarzt, Steuerberater or Schreinerei.
Why is sortBy: rating useful? It returns the best-rated businesses first, so a small maxResults gives you the top of the market instead of the first page of best-match results.
Where do coordinates come from? From the business page itself. Rows have null coordinates when a business does not publish a location.
Can I paste a Gelbe Seiten URL instead? Yes. Put search or business URLs in startUrls. URLs from other websites are ignored; when no usable input remains, the run ends with an INVALID_INPUT outcome and nothing is charged.
How many results can one run return? Up to 500 unique businesses. Free-plan runs return up to 50, which is enough to test the data before you scale up.
Does each result link back to the source? Yes. Every row has detailPageUrl and sourceUrl.
Builder's note
I found that Gelbe Seiten shows the first 40 result cards as page HTML and loads the rest through a separate continuation call, and that sorting by rating only works through that call. I learned that each business page carries its coordinates, categories and opening hours as structured data, which is more reliable than reading the visible page. So the Actor pages through the continuation call for sorted searches, reads that structured data for GPS and hours, and bills only after a validated record is saved to the dataset.
Responsible use
Use public information for lawful purposes. German business contact data can fall under data-protection and marketing rules (GDPR, UWG), including consent rules for unsolicited email. Check each record against its source page and your local rules before outreach.