German Business Directory & Contact Data Scraper — Gelbe Seiten

Scrape business listings from Gelbe Seiten, Germany's largest local business directory. Returns name, address, phone, email, opening hours, ratings, and category for businesses across every German city and trade — nationwide, not just a single search result page.

---

Gelbe Seiten Business Directory Scraper Features

• Extracts business name, address, phone, and email for every listing — email is the field most competing scrapers skip.
• Covers all of Germany, across every city and trade category the directory publishes.
• Returns structured opening hours by weekday, star ratings, accepted payment methods, and each business's full service list.
• Includes precise latitude/longitude for every listing.
• Filter by city with a simple input, or leave it open and pull the entire national catalog.

---

Who Uses Gelbe Seiten Business Data?

• Outbound sales teams — build a prospect list of German SMBs by trade and city, complete with a working email address.
• Agencies & lead-list builders — feed a CRM enrichment pipeline without hand-copying contact details off directory pages.
• Market researchers — measure business density and category distribution across German cities and regions.
• Local SEO & marketing tools — pull competitor listings, ratings, and opening hours for a given trade.
• Mapping & geodata projects — plot business locations with the included coordinates, no separate geocoding step required.

---

How Gelbe Seiten Business Directory Scraper Works

1. Point the actor at specific cities with orte, or leave it empty for the full national directory.
2. It pulls the current listing for every business it finds and opens each one's detail page.
3. Each business is normalized into one flat JSON record — name, address, contact info, hours, ratings, and category all in the same schema.
4. Stop anytime with maxItems, or let it run to build out the complete dataset for the cities you asked for.

---

Input

{
  "maxItems": 500,
  "orte": ["Berlin", "Muenchen"]
}

Field	Type	Default	Description
maxItems	Integer	10	Maximum number of business records to return.
orte	Array of strings	(all of Germany)	Optional. Limit results to these German cities or towns. Leave empty for nationwide coverage.

---

Gelbe Seiten Business Directory Scraper Output Fields

{
  "listing_id": "1091806189",
  "gsbiz_id": "74a88c50-191f-4404-a788-0c34eb5058e8",
  "name": "VIP Fun Inh. Georg Winkel",
  "branche": "Reisebüro",
  "branche_all": ["Reisebüros"],
  "street": "Nöldnerstr. 15",
  "postal_code": "10317",
  "city": "Berlin",
  "district": "Berlin Bezirk Lichtenberg",
  "latitude": 52.502007,
  "longitude": 13.479125,
  "phone": "+493074685283",
  "mobile": "",
  "fax": "",
  "email": "kontakt@example-travel.de",
  "website": "http://example-travel.de",
  "opening_hours": {
    "Montag": "auf Anfrage",
    "Dienstag": "auf Anfrage"
  },
  "rating_avg": 5,
  "rating_count": 1,
  "payment_methods": ["Bar", "Rechnung"],
  "services": ["Reiseberatung", "Flugbuchung"],
  "description": "",
  "logo_url": "",
  "is_paid_listing": false,
  "listing_url": "https://www.gelbeseiten.de/gsbiz/74a88c50-191f-4404-a788-0c34eb5058e8",
  "source_query_branche": "Reisebüro",
  "source_query_ort": "Berlin",
  "scraped_at": "2026-09-26T14:21:34.118Z"
}

Field	Type	Description
listing_id	String	The directory's internal listing identifier.
gsbiz_id	String	Stable unique identifier for this business (also the detail-page UUID).
name	String	Business name.
branche	String	Primary trade category.
branche_all	Array	Every category this business is listed under.
street	String	Street address.
postal_code	String	Postal code.
city	String	City.
district	String	Local district (Stadtteil/Bezirk), where published.
latitude	Number	Latitude.
longitude	Number	Longitude.
phone	String	Landline phone number.
mobile	String	Mobile phone number, where listed.
fax	String	Fax number, where listed.
email	String	Contact email address, where the business publishes one.
website	String	Business website URL.
opening_hours	Object	Hours by German weekday name, where published.
rating_avg	Number	Average star rating, where the listing has reviews.
rating_count	Integer	Number of reviews behind the rating.
payment_methods	Array	Accepted payment methods, where published.
services	Array	Services/offerings listed for this business.
description	String	Free-text business description, where published.
logo_url	String	Business logo image URL, where published.
is_paid_listing	Boolean	Whether this listing is a paid/promoted entry.
listing_url	String	Direct URL to the business's directory page.
source_query_branche	String	Trade category this record was collected under.
source_query_ort	String	City this record was collected under.
scraped_at	String	Timestamp this record was collected.

---

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

---

FAQ

What data does the Gelbe Seiten Business Directory Scraper return?

Business name, full address, coordinates, phone and email contact info, opening hours, star ratings, payment methods, and category — everything a Gelbe Seiten listing publishes, in one flat JSON record per business.

Does it include email addresses?

Yes, where the business publishes one. Email is the field most Gelbe Seiten scrapers on the store leave out entirely, and it's often the difference between a directory row and a usable lead.

Can I limit results to one city?

Yes — pass one or more city names in orte (e.g. ["Berlin"]). Leave it empty and the actor pulls from the entire national directory instead of a single city.

---

Need More Features?

Open an issue if you need a field this actor doesn't return yet.

Why Use Gelbe Seiten Business Directory Scraper?

• Returns email addresses — most Gelbe Seiten scrapers on the store stop at name, address, and phone.
• Covers the entire national directory — every German city and trade category, not a single search page.
• Structured opening hours, ratings, and services included — ready to use without further parsing.