gelbeseiten.de APIgelbeseiten.de ↗
Search German business listings on gelbeseiten.de and retrieve contact info, opening hours, categories, and reviews via a clean JSON API.
curl -X GET 'https://api.parse.bot/scraper/8db9e6fb-e973-409d-adcf-6c5e10667165/search_businesses?page=2&what=steuerberater&where=hamburg' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for businesses by keyword and location on gelbeseiten.de. Returns paginated results. Page 1 returns up to 50 results, subsequent pages return 10 each.
| Param | Type | Description |
|---|---|---|
| page | integer | The page number to retrieve. |
| whatrequired | string | The keyword or category to search for (e.g., 'steuerberater', 'autohaus'). |
| whererequired | string | The location to search in (e.g., 'hamburg', 'berlin'). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"items": "array of business listing objects with uuid, name, address, phone, and url",
"total_count": "integer, total number of results found"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.gelbeseiten.de/gsbiz/27d74d63-ae41-470c-8e1d-61a894e38510",
"name": "Dipl.-Kauffr. Diana Habelt, Steuerberaterin",
"uuid": "27d74d63-ae41-470c-8e1d-61a894e38510",
"phone": "040 67 04 90 40",
"address": "Am Stadtrand 56, 22047 Hamburg (Tonndorf)"
}
],
"total_count": 938
},
"status": "success"
}
}About the gelbeseiten.de API
The Gelbe Seiten API provides 2 endpoints to search German business listings by keyword and location, and to fetch full business profiles. The search_businesses endpoint returns up to 50 results on page one — each with name, address, phone, and a UUID — while get_business_detail returns email, website, opening hours, categories, and customer reviews for any individual listing.
Search Businesses
The search_businesses endpoint accepts two required parameters: what (keyword or category, e.g. steuerberater, autohaus) and where (a city or region, e.g. hamburg, berlin). It returns a total_count integer, the current page number, and an items array. Each item in that array includes the business uuid, name, address, phone, and a url. Page 1 returns up to 50 results; subsequent pages return 10 results each. Use the optional page parameter to paginate through the full result set.
Business Detail
The get_business_detail endpoint takes a single required uuid — obtained from any item in a search_businesses response — and returns a complete profile for that listing. Fields include name, email, phone, address, website, categories (an array of category name strings), opening_hours (an array of objects with day and hours), and reviews (an array of objects each containing author, text, and rating). Fields like email and website return an empty string when the business has not published that information.
Coverage and Geography
Gelbe Seiten is Germany's primary yellow-pages directory. The API covers listings across all German cities and regions searchable on the site. Searches are locale-specific: both what and where values should be supplied in German (e.g. zahnarzt for dentist, münchen for Munich) to match the site's index accurately.
- Build a lead-generation tool targeting German SMBs by category and city using
search_businesses. - Aggregate opening hours for multiple businesses in a city to power a local business finder.
- Collect contact data (phone, email, website) from
get_business_detailfor B2B outreach lists. - Monitor customer review ratings and review text across competitor listings over time.
- Enrich a CRM with verified German business addresses and category tags fetched by UUID.
- Power a location-aware app that surfaces business contact details and hours on demand.
- Audit category coverage across a region by counting
total_countfor different keyword searches.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Gelbe Seiten offer an official developer API?+
What does the `search_businesses` endpoint actually return per result?+
items array includes a uuid, name, address, phone, and url. It does not include email, website, or opening hours at the search level — those fields are only available via get_business_detail using the uuid.How does pagination work, and are there limits on result counts?+
total_count field tells you how many results exist for the query, so you can calculate how many pages to request. Very broad queries may have hundreds of pages.Does the API cover business listings outside Germany?+
where parameter expects German city or region names. You can fork this API on Parse and revise it to target a comparable directory in another country if you need wider geographic coverage.Can I retrieve photos or image galleries for a business listing?+
get_business_detail endpoint covers contact fields, opening hours, categories, and reviews, but does not return photo URLs. You can fork this API on Parse and revise it to add a photos field if the listing page exposes images.