Gelbe Seiten Scraper - German Business Directory

Scrape business data from Gelbe Seiten (German Yellow Pages), one of Germany's largest business directories with millions of listings across all industries and regions.

How to scrape Gelbe Seiten

Give the actor either a Gelbe Seiten search URL in searchUrls, or a search word in searchQuery plus a city in location. Set maxResults to the number of businesses you want (1 to 10,000). Each business becomes one dataset row with name, phone number, address, website and categories. Keep includeDetails on to also get email, fax, coordinates and opening hours from the detail page. You can download the dataset as JSON, CSV or Excel, or fetch it with the Apify API.

Main fields: name, phone, fax, email, website, address, postal_code, city, country_code, latitude, longitude, categories, opening_hours, rating, review_count, source_url, scraped_at.

Price: $2 per 1,000 rows from search results, or $5 per 1,000 rows that include detail page data, plus $0.0005 per run start. The price is the same on every Apify plan.

Example row (trimmed, from a run with includeDetails on):

{
  "name": "Robert & Martin Jaenichen GbR",
  "phone": "030 6 56 02 25",
  "email": "info@konditorei-jaenichen.de",
  "website": "http://www.konditorei-jaenichen.de",
  "address": "Mahlsdorfer Str. 26, 12555 Berlin",
  "city": "Berlin",
  "postal_code": "12555",
  "country_code": "DE",
  "latitude": 52.464397,
  "longitude": 13.584442,
  "categories": [
    "Gaststätten und Restaurants"
  ],
  "opening_hours": [
    "Di 07:00-18:00",
    "Mi 07:00-18:00",
    "Do 07:00-18:00",
    "Fr 07:00-18:00",
    "Sa 08:00-13:00"
  ],
  "source_url": "https://www.gelbeseiten.de/gsbiz/b6d9d5c4-b931-4ce9-9b4e-d05007423056",
  "scraped_at": "2026-11-03T05:00:24Z"
}

FAQ

Can I export Gelbe Seiten listings to Excel or CSV? Yes. The results are stored in an Apify dataset, which you can download as CSV, Excel, JSON, XML or HTML.

Does it include phone numbers and addresses? Yes. Each row has phone, address, postal_code and city. email, fax and coordinates are added with includeDetails.

How many results can I get per search? You set the limit with maxResults, from 1 to 10,000. The run stops when it reaches that number or when the search has no more listings.

Is there an API? Yes. You can start the actor and fetch its dataset with the Apify API, using the input fields shown above.

What data can you extract?

For each business listing, the scraper extracts:

• Business name and categories
• Phone number, fax, and email
• Full address with street, postal code, and city
• Website URL
• GPS coordinates (latitude/longitude)
• Opening hours
• Ratings and review counts (from golocal.de integration)
• Logo image URL

Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client — Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

Apify MCP server URL:

https://mcp.apify.com?tools=santamaria-automations/gelbeseiten-de-scraper

Example prompt once connected:

"Use gelbeseiten-de-scraper to scrape company data from gelbeseiten de. Return results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) will receive the full input schema automatically via add-actor.

How to use

Option 1: Search URL

Paste a Gelbe Seiten search URL directly:

{
  "searchUrls": ["https://www.gelbeseiten.de/suche/zahnarzt/muenchen"],
  "maxResults": 100,
  "includeDetails": true
}

Option 2: Search query + location

Provide a search term and city:

{
  "searchQuery": "restaurant",
  "location": "hamburg",
  "maxResults": 50,
  "includeDetails": true
}

Input parameters

Parameter	Type	Default	Description
searchUrls	array	-	Gelbe Seiten search result URLs
searchQuery	string	-	Search keyword (used if searchUrls is empty)
location	string	berlin	City or region name
maxResults	integer	100	Maximum businesses to scrape (1-10,000)
includeDetails	boolean	true	Fetch detail pages for full data (coordinates, hours, etc.)

Output example

{
  "id": "76c6287c-fd53-42c9-b378-6ead68a639ad",
  "name": "GFAD Softwarehaus GmbH",
  "website": "https://itservice.gfad.de/",
  "phone": "030 26 91 11",
  "email": "info@gfad.de",
  "address": "Huttenstr. 34 -35, 10553 Berlin",
  "city": "Berlin",
  "postal_code": "10553",
  "country": "Germany",
  "country_code": "DE",
  "latitude": 52.529408,
  "longitude": 13.314976,
  "categories": ["Software"],
  "opening_hours": ["Mo-Fr 09:00-18:00"],
  "rating": 4.5,
  "review_count": 12,
  "source_url": "https://www.gelbeseiten.de/gsbiz/76c6287c-fd53-42c9-b378-6ead68a639ad",
  "source_platform": "gelbeseiten.de",
  "scraped_at": "2026-03-26T10:00:00Z"
}

Performance

• Memory: 128 MB (Go binary with TLS fingerprinting)
• Speed: ~50 businesses/page, ~1.5s delay between requests
• SERP only mode: Set includeDetails: false for faster scraping with basic data
• Detail mode: Full data including coordinates, opening hours, fax, and categories

Tips

• Use German search terms for best results (e.g., "Zahnarzt" instead of "dentist")
• Location names work in German (e.g., "Muenchen", "Koeln", "Nuernberg")
• Proxying is handled automatically by the actor; there is no proxy setting to configure
• The scraper extracts email from embedded chat widget data, even when not visually displayed

Related Actors

DACH Business Directories

• wlw.de Scraper -- German B2B supplier directory
• Das Oertliche Scraper -- German phone directory
• Herold.at Scraper -- Austrian Yellow Pages
• FirmenABC.at Scraper -- Austrian business directory
• search.ch Scraper -- Swiss business directory
• Europages Scraper -- 30+ European countries

Swiss Company Data

• Zefix.ch Scraper -- Official Swiss commercial register
• Moneyhouse.ch Scraper -- Swiss company registry

Enrich your leads

• Website Email & Phone Scraper -- Extract emails and phones from company websites
• Website Contact Extractor -- Extract team members and decision-makers
• Google Maps Scraper -- Find businesses by location
• Trustpilot Reviews Scraper -- Get company reviews and ratings

Data protection

This actor returns only data that is publicly visible on the source pages. Results can include personal data, such as names, phone numbers, email addresses and addresses of private persons, sole traders or contact persons. Where the source labels an entry type, it is included so you can filter the results yourself.

You are responsible for using the data lawfully, including the GDPR/DSGVO, national data-protection laws and unfair-competition rules (e.g. UWG) for marketing and outreach.