GoYellow.de Business Directory Scraper

Scrape German local business listings from GoYellow.de by keyword and city.

Use this actor to collect structured business leads with names, categories, addresses, phone numbers, websites, ratings, review counts, opening-status text, coordinates, GoYellow profile URLs, and source search URLs.

What does GoYellow.de Business Directory Scraper do?

GoYellow.de Business Directory Scraper extracts public business listings from GoYellow.de search result pages.

It is designed for German local-business research where you need repeatable exports instead of manually copying directory pages.

The actor can search by business type and location, follow pagination, and optionally open each company profile page for phone and website enrichment.

Typical examples:

• Restaurants in Berlin
• Dentists in Hamburg
• Hair salons in Munich
• Tax advisors in Cologne
• Hotels in Frankfurt

Who is it for?

This scraper is useful for teams that need German SMB data.

• 🧲 Sales teams building regional prospect lists
• 📍 Local SEO agencies mapping competitors and citations
• 🏢 B2B researchers profiling German business categories
• 🧾 Data enrichment teams validating addresses and public contact pages
• 🧑‍💻 Automation builders feeding CRM, Clay, Airtable, or spreadsheets

Why use this actor?

GoYellow is a German business directory with public local listings.

Manual collection is slow because each search can span many pages and detail pages.

This actor turns those pages into clean JSON records.

Benefits:

• Search by keyword and city
• Export directly to JSON, CSV, Excel, or API
• Enrich with detail-page phone and website links
• Keep source and profile URLs for verification
• Limit result volume for cost control

Data you can extract

Field	Description
name	Business name
categories	Category chips shown by GoYellow
address	Full visible address
streetAddress	Street and house number
postalCode	German postal code
city	City/locality
country	Country code when present
phone	Phone number from detail page when public
website	External business website when public
rating	GoYellow rating value
reviewCount	Number of reviews
openingStatus	Visible opening-status text
latitude	Latitude from structured metadata
longitude	Longitude from structured metadata
detailUrl	GoYellow profile URL
sourceUrl	Search page where the listing was found
searchKeyword	Keyword used for the result
searchLocation	Location used for the result
scrapedAt	ISO timestamp of extraction

How much does it cost to scrape GoYellow.de businesses?

The actor uses pay-per-event pricing.

You pay a small run-start event plus a per-result event for each business saved.

The default input is intentionally small so your first run stays cheap.

For low-cost testing, use maxItems between 10 and 25.

For enriched lead lists, keep includeDetailPages enabled.

For faster listing-only exports, disable detail-page enrichment.

How to scrape GoYellow.de

1. Open the actor on Apify.
2. Enter a business type in Business type / keyword.
3. Enter a German city or location.
4. Choose a maximum number of businesses.
5. Keep detail pages enabled if you need phone and website fields.
6. Start the run.
7. Download the dataset as CSV, Excel, JSON, or access it through the API.

Input options

Business type / keyword

The main GoYellow search term.

Examples:

• Restaurant
• Zahnarzt
• Friseur
• Steuerberater
• Rechtsanwalt

City or location

The German place to search.

Examples:

• Berlin
• Hamburg
• München
• Köln
• Frankfurt am Main

Additional searches

Use queries to run several keyword/location pairs in one execution.

Example:

[
  { "keyword": "Restaurant", "location": "Berlin" },
  { "keyword": "Zahnarzt", "location": "Hamburg" }
]

Direct GoYellow search URLs

Use searchUrls when you already have exact GoYellow search pages.

Example:

[
  { "url": "https://www.goyellow.de/suche/restaurant/berlin" }
]

Maximum businesses

maxItems controls the total number of dataset rows saved across all searches.

Open detail pages

includeDetailPages controls enrichment.

When enabled, the actor visits profile pages to look for phone numbers, websites, improved rating metadata, and coordinates.

Example input

{
  "keyword": "Restaurant",
  "location": "Berlin",
  "maxItems": 25,
  "includeDetailPages": true
}

Example output

{
  "name": "ALEX Berlin Uber Platz",
  "categories": ["Cafes und Kneipen", "Restaurants und Gaststätten"],
  "address": "Hedwig-Wachenheim-Straße 14, 10243 Berlin",
  "streetAddress": "Hedwig-Wachenheim-Straße 14",
  "postalCode": "10243",
  "city": "Berlin",
  "country": "DE",
  "phone": "030233210660",
  "website": "https://www.dein-alex.de/berlin-uber-platz",
  "rating": 5,
  "reviewCount": 1,
  "openingStatus": "öffnet in 1 Std.",
  "latitude": 52.50443966,
  "longitude": 13.44317416,
  "detailUrl": "https://www.goyellow.de/home/cafe-kneipe-alex-berlin-uber-platz-berlin--44gx7p.html",
  "sourceUrl": "https://www.goyellow.de/suche/restaurant/berlin",
  "searchKeyword": "Restaurant",
  "searchLocation": "Berlin",
  "scrapedAt": "2026-06-17T07:00:00.000Z"
}

Tips for better results

• Use German business terms for better matching.
• Start with a single city before running many locations.
• Increase maxItems only after checking sample data.
• Disable detail pages if you only need names and addresses.
• Keep source URLs when reconciling exports with the website.

Common use cases

• Local lead generation
• German market mapping
• Regional competitor discovery
• CRM enrichment
• Agency prospecting
• Store-location research
• Local SEO citation audits

Integrations

You can connect the dataset to common tools.

• 🧾 Export CSV to Google Sheets or Excel
• 🧲 Send leads to a CRM through Make or Zapier
• 🧱 Load JSON into a warehouse or database
• 🧪 Validate company websites with a follow-up actor
• 📬 Combine with email discovery workflows where legally appropriate

API usage with Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/goyellow-business-directory-scraper').call({
  keyword: 'Restaurant',
  location: 'Berlin',
  maxItems: 25,
  includeDetailPages: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

API usage with Python

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/goyellow-business-directory-scraper').call(run_input={
    'keyword': 'Restaurant',
    'location': 'Berlin',
    'maxItems': 25,
    'includeDetailPages': True,
})

items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

API usage with cURL

curl -X POST "https://api.apify.com/v2/acts/automation-lab~goyellow-business-directory-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"Restaurant","location":"Berlin","maxItems":25,"includeDetailPages":true}'

MCP usage

Use this actor from Apify MCP-compatible tools.

MCP URL:

https://mcp.apify.com/?tools=automation-lab/goyellow-business-directory-scraper

Claude Code setup example:

$claude mcp add apify-goyellow --transport http "https://mcp.apify.com/?tools=automation-lab/goyellow-business-directory-scraper"

Claude Desktop setup: open Claude Desktop settings, go to Developer / MCP servers, add a server named apify-goyellow, and use the Apify MCP URL above. If you manage Claude Desktop with a JSON config, add this server entry:

{
  "mcpServers": {
    "apify-goyellow": {
      "url": "https://mcp.apify.com/?tools=automation-lab/goyellow-business-directory-scraper"
    }
  }
}

Cursor setup: open Cursor Settings → MCP, choose Add new global MCP server, set the transport to HTTP, and paste the same Apify MCP URL. Name the server apify-goyellow so prompts can refer to it clearly.

VS Code setup: install or enable an MCP-capable assistant extension, add an HTTP MCP server named apify-goyellow, and use https://mcp.apify.com/?tools=automation-lab/goyellow-business-directory-scraper as the server URL.

Example prompt for Claude Code:

Use the automation-lab/goyellow-business-directory-scraper MCP tool to collect 50 dentists in Hamburg and summarize the exported fields.

Example prompt for Claude Desktop, Cursor, or VS Code:

Find public GoYellow.de listings for restaurants in Berlin with the MCP tool and return a table with name, address, phone, website, rating, and profile URL.

Detail-page enrichment

Search result pages usually include name, categories, address, coordinates, rating cues, and profile URLs.

Detail pages can add phone numbers and external websites.

Because every detail page is another HTTP request, enrichment is slower than listing-only scraping.

Use the toggle based on your use case.

Performance notes

This is an HTTP actor, not a browser actor.

It does not launch Chrome or Playwright.

That keeps runs lightweight and makes small exports fast.

The actor uses a 256 MB default memory setting.

Data quality notes

Public directory data can vary by listing.

Some businesses may not have a public phone number or website.

Some listings may only show limited rating data.

The actor leaves missing public fields as null rather than inventing values.

FAQ

Is this an official GoYellow.de API?

No. This actor extracts public GoYellow.de pages and converts visible listing data into a structured Apify dataset.

Can I scrape multiple cities in one run?

Yes. Use the queries array to provide several keyword and location pairs in one execution.

Troubleshooting

Why is phone empty?

Phone numbers are taken from public detail-page tel: links. If the listing does not expose one, the field stays empty.

Why are there fewer items than requested?

The selected keyword/location may have fewer public results, or GoYellow may not expose enough pages for that query.

Why should I use German keywords?

GoYellow is a German directory. German category terms usually match more relevant listings than English translations.

Legality and responsible use

This actor extracts publicly available GoYellow.de pages.

You are responsible for using the data in compliance with applicable laws, platform terms, privacy rules, and outreach regulations.

Avoid spam, respect opt-out requests, and process personal data only when you have a valid legal basis.

Related scrapers

Other automation-lab actors that may pair well with this workflow:

• https://apify.com/automation-lab/das-telefonbuch-scraper
• https://apify.com/automation-lab/11880-local-business-directory-scraper
• https://apify.com/automation-lab/website-contact-finder

Changelog

0.1

Initial version for keyword/location GoYellow.de business searches with optional detail-page contact enrichment.

Support

If a query stops returning expected results, include the input JSON and run ID when requesting support.

Summary

GoYellow.de Business Directory Scraper helps you turn public German business directory pages into structured datasets for lead generation, local SEO, market research, and enrichment workflows.