Gelbe Seiten Scraper — German Business Directory Data

Scrape business listings from Gelbe Seiten, Germany's yellow pages directory with millions of registered businesses across every trade and city. Search by category keyword and location, and export clean structured business records with names, categories, addresses, zip codes, phone numbers, websites, and customer ratings. No login, no cookies, no API key.

Why use this actor?

Gelbe Seiten is the reference directory for local businesses in Germany. Craftsmen, doctors, lawyers, tax advisors, restaurants, salons, workshops: if a German business wants to be found, it is listed here. Every listing carries the data a sales or research team actually needs: what the business does, where it sits, and how to reach it.

Typical uses:

• Lead generation — build prospect lists for a trade and city, ready for a CRM import.
• Local market research — count and map businesses per category and region, compare cities.
• Data enrichment — match business names to addresses, phone numbers, websites, and ratings.
• Competitor analysis — list every provider in a category around a location, sorted with ratings.

The actor reads the server-rendered search results directly, so records are complete and consistent. It only returns contact details that businesses publish openly on the directory.

How to scrape Gelbe Seiten data

1. Open the actor and set a Search Query — a trade or category keyword in German, such as friseur, steuerberater, zahnarzt, or italienisches restaurant. Business names work too.
2. Set a Location — a city, town, or zip code (berlin, muenchen, frankfurt am main, 10115).
3. Set Max Results to the number of businesses you want.
4. Keep the residential proxy prefill and click Start.
5. When the run finishes, export the dataset as JSON, CSV, or Excel, or pull it from the Apify API.

The actor loads the first results page and then pages through the load-more endpoint automatically until it reaches your Max Results or runs out of matching businesses.

Input

Field	Type	Required	Description
searchQuery	String	No	Trade or category keywords in German (e.g. friseur, steuerberater). Defaults to friseur if empty.
location	String	No	City, town, or zip code to search in (e.g. berlin, 10115). Defaults to berlin if empty.
maxResults	Integer	No	Maximum number of businesses to return (default: 50, max: 1000).
proxyConfiguration	Object	No	Proxy settings. Residential proxies recommended.

Example input:

{
    "searchQuery": "steuerberater",
    "location": "muenchen",
    "maxResults": 100,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Output

One record per business listing:

Field	Type	Description
businessName	String	Business name as listed on Gelbe Seiten
category	String	Primary branche/category (e.g. Friseure, Steuerberater)
address	String	Street address
zipCode	String	German postal code (PLZ)
city	String	City
district	String	City district (Stadtteil), when shown
phone	String	Phone number, when publicly listed
website	String	Business's own website, when published
rating	Number	Average customer rating (0–5), when shown
reviewCount	Number	Number of customer reviews, when shown
profileText	String	Short free-text presentation from the listing
openingStatus	String	Opening state at scrape time (e.g. Geschlossen – Öffnet um 10:00)
distance	String	Distance from the search center (e.g. 3,4 km)
url	String	Full URL of the business profile on Gelbe Seiten
businessId	String	Internal Gelbe Seiten listing ID
searchQuery	String	The query that returned this business
searchLocation	String	The location used for the search
scrapedAt	String	ISO timestamp of the scrape

Example output:

{
    "businessName": "Hair Affair",
    "category": "Friseure",
    "address": "Friesenstr. 8",
    "zipCode": "10965",
    "city": "Berlin",
    "district": "Kreuzberg",
    "phone": "030 6 91 90 89",
    "website": null,
    "rating": 5.0,
    "reviewCount": 1,
    "profileText": "Im Friseursalon Hair Affair in Berlin bietet Inhaberin Jessica Koch Ihnen die ganze Palette von klas...",
    "openingStatus": "Geschlossen – Öffnet um 10:00",
    "distance": "3,4 km",
    "url": "https://www.gelbeseiten.de/gsbiz/dbb0b6e7-fc4d-48ee-8309-909beb906c9c",
    "businessId": "dbb0b6e7-fc4d-48ee-8309-909beb906c9c",
    "searchQuery": "friseur",
    "searchLocation": "berlin",
    "scrapedAt": "2026-07-10T09:30:00.000Z"
}

Cost estimate

The actor uses lightweight HTTP requests (no browser). The first 50 businesses come from a single page load; after that each request adds 10 businesses. A 100-result run typically finishes in under a minute and uses only a few cents of platform credits plus the per-result fee.

Tips

• Search queries and locations are the same words you would type on gelbeseiten.de. German keywords match best (rechtsanwalt, not lawyer).
• Zip codes work as locations and give tighter geographic scoping than city names.
• Multi-word queries are fine: italienisches restaurant, frankfurt am main.
• Ratings and websites only appear when the business publishes them; expect them on a subset of records.

Limitations

• The actor scrapes the search results list, not the full detail pages. Fields that only exist on detail pages (opening-hours tables, email addresses, photos) are not included.
• Gelbe Seiten covers Germany only.
• distance is relative to the search center Gelbe Seiten picks for your location.

Legal

This actor only extracts business information that is publicly listed on the Gelbe Seiten directory, where businesses publish it precisely to be found and contacted. No login is bypassed and no private data is collected. You are responsible for using the data in compliance with applicable laws (GDPR, competition law) in your jurisdiction.