Gelbe Seiten Germany Business Leads Scraper

Here is one real result, with every field the actor returns:

{
  "businessName": "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 (Köpenick)",
  "category": "Gaststätten und Restaurants",
  "url": "https://www.gelbeseiten.de/gsbiz/b6d9d5c4-b931-4ce9-9b4e-d05007423056",
  "aiProfileSummary": "Robert & Martin Jaenichen GbR is a restaurant located in Berlin (Köpenick) that offers a variety of dining options. They specialize in providing a welcoming atmosphere for guests to enjoy delicious meals.",
  "aiLeadScore": 85,
  "aiLeadTier": "A",
  "aiLeadRationale": "The business is in the restaurant category with complete contact information and an accessible website, indicating strong outreach potential.",
  "source": "Gelbe Seiten",
  "observedAt": "2026-08-14T07:53:44.346Z"
}

The most complete Gelbe Seiten business leads scraper available. It returns every contact field a Gelbe Seiten listing exposes, from business name, phone and email to website, full address and category, plus optional AI enrichment (profile summary, lead score and tier), and gives you keyword and city inputs to target exactly the German businesses you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches Gelbe Seiten for your keyword in the German city you set, pages through the matching business listings, and writes one clean lead record per business to the run's dataset. Each record carries the business name, phone, email, website, full address and category. Missing source values are returned as null, and optional AI add-ons (profile summary, lead score and tier with rationale) run per business when enabled on a paid plan.

Data covers business listings across Germany from Gelbe Seiten. Gelbe Seiten is bot protected, so the actor runs over Apify RESIDENTIAL proxy in Germany.

Quickstart

Open the actor, paste this into the input, and press Run. It returns 3 restaurant leads in Berlin, with both AI add-ons enabled.

{
  "keyword": "restaurant",
  "city": "berlin",
  "maxBusinesses": 3,
  "withAiProfileSummary": true,
  "withAiLeadScore": true
}

Both keyword and city are required. Use German spellings for cities (for example muenchen, koeln). maxBusinesses defaults to 10.

Input reference

Field	Type	Required	Default	Description
keyword	string	yes	restaurant	What to search for, for example restaurant, zahnarzt, hotel, rechtsanwalt, friseur. Also accepts search.
city	string	yes	berlin	German city or place, for example berlin, muenchen, hamburg, koeln. Also accepts location.
maxBusinesses	integer	no	10	Maximum businesses to collect.
withAiProfileSummary	boolean	no	false	Paid add-on. Adds aiProfileSummary. Charged only on usable output. Requires a paid Apify plan.
withAiLeadScore	boolean	no	false	Paid add-on. Adds aiLeadScore, aiLeadTier and aiLeadRationale. Charged only on usable output. Requires a paid Apify plan.

Output reference

One dataset item per business. Types: string, integer, or null when the source value is absent.

Field	Type	Description
businessName	string	Business name.
phone	string	Phone number, or null.
email	string	Email address, or null.
website	string	Website URL, or null.
address	string	Full street address including postal code and city.
category	string	Primary business category (German), or null.
url	string	Gelbe Seiten profile URL for the business.
aiProfileSummary	string	AI concise business profile. null unless withAiProfileSummary produced output.
aiLeadScore	integer	AI lead qualification score (0 to 100). null unless withAiLeadScore produced output.
aiLeadTier	string	AI lead tier (for example A, B, C). null unless withAiLeadScore produced output.
aiLeadRationale	string	AI rationale for the score. null unless withAiLeadScore produced output.
source	string	Always Gelbe Seiten.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"keyword": "restaurant", "city": "berlin", "maxBusinesses": 3, "withAiProfileSummary": true, "withAiLeadScore": true}):

{
  "businessName": "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 (Köpenick)",
  "category": "Gaststätten und Restaurants",
  "url": "https://www.gelbeseiten.de/gsbiz/b6d9d5c4-b931-4ce9-9b4e-d05007423056",
  "aiProfileSummary": "Robert & Martin Jaenichen GbR is a restaurant located in Berlin (Köpenick) that offers a variety of dining options. They specialize in providing a welcoming atmosphere for guests to enjoy delicious meals.",
  "aiLeadScore": 85,
  "aiLeadTier": "A",
  "aiLeadRationale": "The business is in the restaurant category with complete contact information and an accessible website, indicating strong outreach potential.",
  "source": "Gelbe Seiten",
  "observedAt": "2026-08-14T07:53:44.346Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~gelbeseiten-germany-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"zahnarzt","city":"muenchen","maxBusinesses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~gelbeseiten-germany-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"hotel","city":"hamburg","maxBusinesses":100}'

Apify CLI:

apify call scrapers_lat/gelbeseiten-germany-scraper \
  --input '{"keyword":"friseur","city":"koeln","maxBusinesses":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per business lead returned (result event). See the pricing tab for the current per-result price.
• Optional AI add-ons (ai_profile_summary, ai_lead_score) are billed separately and only when they produce usable output, and only on paid Apify plans.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run. Upgrade for higher maxBusinesses.

FAQ and troubleshooting

A run returned 0 records. Why? No listings matched the keyword in that city, or the city spelling was not recognized. Use German spellings (muenchen, koeln) and a broad keyword. Zero-result runs are not charged.

Why is the email or website missing? Not every Gelbe Seiten listing publishes an email or website. Those fields are returned as null when absent; the actor never invents them.

Which cities can I search? Any German city or place recognized by Gelbe Seiten. Pass it in city using German spelling.

Do the AI fields cost extra? Yes. They are opt-in paid add-ons, billed only when they return usable output, and disabled on free Apify plans.

Is this an official Gelbe Seiten tool? No. This actor is independent and has no affiliation with Gelbe Seiten. It reads only data that is publicly available on the platform. Use it in accordance with Gelbe Seiten's terms of service.

Related scrapers

• 11880 Germany Business Scraper: German business listings with contacts.
• Paginas Amarillas Scraper: Spanish-language yellow pages business leads.
• Pagine Gialle Italy Scraper: Italian business listings with contacts.
• Golden Pages Ireland Scraper: Irish business directory leads.
• Cybo Business Leads Scraper: Global business directory leads.
• Brownbook Business Scraper: Global business listings with contacts.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Gelbe Seiten. Accesses only publicly available data. Use in accordance with Gelbe Seiten's terms of service.