Gelbe Seiten Business Scraper

Collect public German business listings from Gelbe Seiten by business type and city, postal code, or district. Each dataset item represents one deduplicated business and includes its name, category, address, public phone/email/website where shown, ratings, and the original Gelbe Seiten detail-page URL.

Best fit

Use this Actor for local market research, German B2B prospecting, and directory-data workflows that start with a business type and location. It accepts either search pairs such as Zahnarzt + Berlin or existing Gelbe Seiten result and business URLs. It is not a tool for private data, login-only information, or businesses outside Gelbe Seiten.

Quick start

{
  "searches": [{ "query": "Zahnarzt", "location": "Berlin" }],
  "maxResults": 50,
  "enrichDetails": true
}

Set enrichDetails to false for faster result-card extraction. The actor follows Gelbe Seiten' own continuation endpoint until it reaches maxResults or exhausts the search.

Input reference

Field	Type	What it controls
searches	array	One or more { query, location } pairs, such as Zahnarzt and Berlin.
startUrls	array	Existing Gelbe Seiten search or business URLs; they retain the URL's public filters.
maxResults	integer	A 1–500 cap on unique business rows and the matching billable events.
enrichDetails	boolean	Whether to visit each public detail page for additional public contact and opening-hour fields.

Output

{
  "businessName": "Zahnarztpraxis Petra Hartmann",
  "primaryCategory": "Zahnärzte",
  "address": "Friedelstr. 14, 12047 Berlin (Neukölln)",
  "phone": "030 6 24 31 33",
  "email": "info@example.de",
  "rating": 4.9,
  "detailPageUrl": "https://www.gelbeseiten.de/gsbiz/...",
  "scrapedAt": "ISO 8601 extraction timestamp"
}

Optional public fields are null when Gelbe Seiten does not display them. Every item retains sourceUrl and detailPageUrl for provenance.

Practical workflow

A local-services agency can search Steuerberater in Hamburg, limit the run to 100 businesses, then sort the returned records by rating and retain the source URL with each CRM import. The result is a defensible territory list: a person reviewing the import can trace every contact field back to the matching public directory page.

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":"Zahnarzt","location":"Berlin"}],"maxResults":25,"enrichDetails":false}'

After completion, read the default dataset and the OUTPUT key in the default key-value store. Keep detailPageUrl with any downstream record so the source remains reviewable.

AI agents through Apify MCP

Use the Gelbe Seiten Business Scraper to collect up to 25 public dental practices in Berlin. Return business name, address, phone, website, rating, and source URL. Read the terminal outcome and dataset, preserve source URLs as provenance, and stay within the requested result cap and cost.

The AI agent can page through the dataset after the run and use RUN_SUMMARY to understand the final scope and any warnings.

Pricing

This Actor uses Pay per event plus Apify platform usage. It charges $0.005 for each unique, validated business-found dataset row and $0.00005 when a run starts. A 50-business run has a maximum event charge of $0.25, plus platform usage. Open the live Pricing tab for the current event details and use Apify run cost controls for a hard billing limit.

Builder's note

I designed the actor around the fact that Gelbe Seiten exposes the first 50 result cards as HTML but loads further cards through a POST continuation endpoint. The actor keeps that continuation path separate from detail enrichment and only charges after a complete record has passed validation and reached the dataset. This prevents a retry, a duplicate card, or a missing optional field from becoming a billable result.

Focused standalone workflow

This actor works as a focused standalone workflow for public German Gelbe Seiten business records and preserves the source page for later validation.

Responsible use

Use only public information for lawful, authorized workflows and respect applicable privacy, marketing, and data-protection requirements. Verify records against their source page before outreach or other consequential use.