Gelbe Seiten Business Scraper avatar

Gelbe Seiten Business Scraper

Pricing

from $2.40 / 1,000 business founds

Go to Apify Store
Gelbe Seiten Business Scraper

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

Khadin Akbar

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

9 hours ago

Last modified

Features

Limited permissions

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 latitude and longitude for 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.
  • categories and fax from 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

FieldTypeWhat it controls
searchesarrayOne or more { query, location } pairs, such as Zahnarzt and Berlin. Location accepts a city, district or postal code.
startUrlsarrayExisting Gelbe Seiten search or business URLs. Search URLs keep their public filters.
maxResultsinteger1 to 500 unique businesses across all inputs. This is also the cap on billable results. Free-plan runs return up to 50.
sortBystringrelevance (best match, default) or rating (highest rated first). Applies to searches.
enrichDetailsbooleanVisit 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 sizeCharged events
50 businesses50 business events and 1 start event
200 businesses200 business events and 1 start event
500 businesses500 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

ActorWhy pair it
Google Maps Leads ScraperAdd Google Maps businesses to the same territory list.
Bulk Website Contact ExtractorPull more contacts from the websites found here.
Email Address ValidatorCheck the emails before outreach.
Universal Lead FinderSearch 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.