Gelbe Seiten Scraper - German B2B Business Directory

What does Gelbe Seiten Scraper do?

Gelbe Seiten Scraper extracts business listings from Gelbe Seiten (gelbeseiten.de), Germany's best-known business directory (Yellow Pages Germany). Pick one or more categories (Branchen) and cities (Orte) and get clean, structured B2B data: business name, category, street, PLZ (postal code), city, district, business phone, website, rating and number of reviews, and optionally weekly opening hours, GPS coordinates, description, services and payment methods.

Use it as a Gelbe Seiten API for market research, local competitor analysis, territory planning, B2B lead lists of companies (Handwerker, Steuerberater, Friseure, Ärzte, Restaurants...), or to enrich your CRM with addresses and websites.

Why use this Gelbe Seiten scraper?

• More than 50 per city. A Gelbe Seiten city page shows only the first 50 businesses. The Actor also reads the city's district pages (Berlin Bezirke, Munich, Leipzig or Hamburg Stadtteile...) and merges them: about 420 unique electricians in Berlin instead of 50.
• Clean fields. Street, PLZ, city and district split; rating as a number; website decoded; one record per business.
• Opening hours on request. Turn on Include opening hours and details to get the weekly hours (Mo 09:00-12:00...), latitude/longitude, description, services and payment methods. Same price.
• No duplicates charged. A business listed in several districts or categories is saved and billed once.
• Privacy by default. E-mail addresses are off by default. When turned on, only role mailboxes (info@, kontakt@, office@...) are returned; personal-looking addresses are never returned.
• Respectful and fast. Plain HTTP, no browser, no login, follows robots.txt: 400+ businesses in about 20 seconds.

How much does it cost to scrape Gelbe Seiten?

$1.50 per 1,000 businesses saved to the dataset. Duplicates, unknown categories and empty searches are free. Cap spending with Max businesses and the run's maximum cost.

How to scrape Gelbe Seiten

1. Enter Categories (Branchen) as written on Gelbe Seiten: Elektriker, Friseur, Steuerberater, Heizung & Sanitär, Zahnarzt...
2. Enter Cities (Orte): Berlin, München, Köln, or a district like Berlin Bezirk Mitte. Every category is combined with every city.
3. Or paste Gelbe Seiten URLs: listing pages like https://www.gelbeseiten.de/branchen/elektriker/berlin or single business pages https://www.gelbeseiten.de/gsbiz/<id>.
4. Set Max businesses, and turn on details or e-mails if you need them.
5. Click Start and download JSON, CSV or Excel, or use the Apify API.

Not sure about the category name? Open the Gelbe Seiten Branchenbuch and use the name from there. If a category/city pair does not exist on Gelbe Seiten, the Actor logs it and moves on at no cost.

Input example

{
  "branchen": ["Elektriker", "Heizung & Sanitär"],
  "orte": ["Berlin", "Potsdam"],
  "maxItems": 1000,
  "includeDistricts": true,
  "includeDetails": true,
  "includeEmails": false
}

Output example

{
  "id": "c8d1de24-3efc-4429-a0d3-eff63484a56e",
  "listingId": "1095012971",
  "name": "Blachnierz & Söhne Elektroinstallationsges. mbH",
  "category": "Elektroinstallationen",
  "street": "Buckower Chaussee 82",
  "postalCode": "12277",
  "city": "Berlin",
  "district": "Marienfelde",
  "phone": "030 7 21 50 20",
  "website": "https://www.elektro-bs.de",
  "rating": null,
  "reviewsCount": 0,
  "isHighlighted": false,
  "url": "https://www.gelbeseiten.de/gsbiz/c8d1de24-3efc-4429-a0d3-eff63484a56e",
  "country": "DE",
  "latitude": 52.410816,
  "longitude": 13.374427,
  "openingHours": ["Mo 09:00-12:00", "Mo 14:00-17:30", "Di 09:00-12:00", "Di 14:00-17:30", "Fr 09:00-12:00", "Fr 14:00-17:30"],
  "services": ["Störungsbeseitigungen", "Projektierung", "Alarmanlageninstallation"],
  "paymentMethods": "Bar, Rechnung, Vorkasse, electronic cash",
  "lastUpdated": "2026-08-30",
  "detailsScraped": true,
  "email": null,
  "source": "gelbeseiten.de",
  "searchUrl": "https://www.gelbeseiten.de/branchen/elektriker/berlin",
  "scrapedAt": "2026-10-12T21:10:00+00:00"
}

Fields you get

Field	Description
name, category	Business name and main category on Gelbe Seiten
street, postalCode, city, district, country	Address split into parts (PLZ = postal code)
phone	Business phone number as published in the directory
website	Business website
rating, reviewsCount	Average rating (1-5) and number of reviews on Gelbe Seiten
isHighlighted	Premium/partner listing on Gelbe Seiten
logoUrl, shortDescription	Logo and teaser text when present
openingHours	Weekly opening hours (with details on)
latitude, longitude	GPS coordinates (with details on)
description, services, paymentMethods, lastUpdated, businessTypes	From the business page (with details on)
email	Role mailbox only, when Include business e-mail is on
id, listingId, url, source, searchUrl, scrapedAt	Identifiers and run metadata

Limits

• Gelbe Seiten's robots.txt closes its search (/suche), and the "Mehr anzeigen" button loads more results through that search, so this Actor reads the first 50 businesses of each listing page plus the district pages. Very large categories in a single district can therefore be incomplete. To cover more, add neighbouring towns or more specific categories.
• Ratings, websites, opening hours and logos are only present when the business published them (for example, about 1 in 10 electricians in Berlin has reviews).

FAQ

Is it legal to scrape Gelbe Seiten? The Actor reads only public pages, without login, and respects robots.txt. The data is business listing data. B2B use only: you are responsible for complying with GDPR and the German UWG. Phone numbers and e-mails of sole proprietors can be personal data. Do not use the results for unsolicited e-mail or phone marketing (cold e-mail spam).

Why are e-mails off by default? Many small businesses list private addresses. When you turn e-mails on, only generic role mailboxes are returned, and e-mails inside descriptions are masked unless e-mails are on.

Do I need a proxy? Usually not. If Gelbe Seiten starts blocking, the Actor switches to Apify Proxy when it is enabled in the input.

Something broke or a field is missing? Open an issue on the Actor page with your input and run ID. We usually reply within a day.