# Changelog of Gelbeseiten Germany Scraper (`blackfalcondata/gelbeseiten-de-scraper`) Actor

- **URL**: https://apify.com/blackfalcondata/gelbeseiten-de-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/blackfalcondata/gelbeseiten-de-scraper.md

## Changelog

All notable changes to this Actor are documented here.

### \[0.1.0] — 2026-10-24

Initial release.

#### Fixed

- Compact output preserves the stable listing identifier for matching records across runs.
- Incremental runs with a Max Results cap now keep moving through the directory instead of re-reading the same first results, so every run delivers up to your cap of new or changed businesses.
- Incremental runs report businesses that left the directory (with Emit Expired) even when a search now returns nothing, and expired rows count towards Max Results.
- A run whose searches could not be read from Gelbeseiten now fails or is marked degraded instead of reporting success or "no results".
- A failed detail lookup no longer shows an unchanged business as updated in incremental runs.
- Incremental runs report a business as updated when only its partner ratings, contact details or profile fields changed.
- A business whose detail or profile page could not be read is kept as unchanged with its last known state, so neither that run nor the next healthy run reports a false update.
- Incremental runs no longer report an unchanged business as updated when its profile or detail page could not be read, or again when it can be read the next time; a name, phone or address change seen in that run is still reported once.
- Fax numbers are delivered in `fax`/`faxNumbers` instead of being mixed into `phones`.
- Note: change detection now covers the new profile fields, so an existing incremental state reports each business as updated once on the first run after this release.

#### Added

- Search gelbeseiten.de by trade and town (or nationwide) and get name, category, phone, e-mail, website, address, coordinates and rating per business.
- Paste gelbeseiten.de search URLs as start URLs.
- Category pages (`/branchen/...`) and business pages (`/gsbiz/...`) are accepted as start URLs.
- New Sort Order input (relevance, rating, distance); a start URL's `sortierung` is respected.
- Full details now include each business's public profile: weekly opening hours, fax, payment methods, services, keywords, languages, social media links, images, logo and recent reviews.
- Runs stop cleanly at your maximum cost per run.
