This GoYellow.de scraper tutorial shows how to turn a keyword and city search into a reviewable CSV with the GoYellow.de Leads Scraper template for UScraper. You will import the workflow, set the search URL, confirm the export path, validate the first rows, and handle common pagination or blank-field issues before scaling.
Before you start
Prerequisites for scraping GoYellow.de leads
You need UScraper installed as a local desktop app, the GoYellow.de Leads Scraper template, a target keyword, a target city, and a folder where the CSV should be saved. Start with one narrow search, such as a trade in one city, because directory layouts and published contact fields can vary by listing.
Use the official GoYellow.de directory manually first. Open a search result page, review whether the listings match your research scope, then check the current GoYellow terms, privacy policy, and robots.txt. This article is a technical runbook, not legal advice.
Treat compliance as part of the workflow. Do not bypass access controls, keep request volume modest, collect only fields you actually need, and document why the exported lead data is allowed to be used.
Workflow
How the GoYellow.de scraper works
The workflow definition starts from a public GoYellow.de search URL. The bundled example uses https://www.goyellow.de/suche/Auto/Berlin, but you should replace that with the approved keyword and city path for your project.
UScraper loads the page, waits briefly, runs a normalization script, and creates hidden .uscraper-lead-row elements with consistent data attributes. Structured Export then reads those normalized rows instead of trying to scrape every mixed card element directly. That is useful because business directory pages often combine visible text, JSON-LD snippets, contact links, social links, and pagination controls in different parts of the DOM.
| Block | Purpose | What to verify |
|---|---|---|
| Navigate | Opens the keyword and city search URL | Replace the sample Auto in Berlin path before a real run. |
| Wait for Page Load and Sleep | Lets the page and consent state settle | Increase the wait if cards render slowly. |
| Inject JavaScript | Normalizes JSON-LD or visible listing text into stable rows | Confirm #uscraper-goyellow-rows exists after injection. |
| Structured Export | Appends rows to goyellow_de_leads_scraper.csv | Check filename, save folder, headers, and append mode. |
| Element Exists and Click | Detects and follows the next-page link | Stop after the first page if you only need validation. |
Export shape: GoYellow.de to CSV
No CSV sample ships with the bundle, so the workflow definition is the contract you should validate. The export block writes headers and appends rows across pages.
| Column | What it captures | Validation check |
|---|---|---|
titel | Company or listing name | Compare against the visible card title. |
branche | Branch, category, or business type | Normalize later if your CRM needs a controlled taxonomy. |
oeffnungszeiten | Opening-hours text when available | Expect blanks or changing values. |
strasse | Street address | Check German street abbreviations before imports. |
plz | Postal code | Use it for city and region filters. |
stadt | City name | Compare against the search location. |
e_mail | Visible email or mail link | Blank is normal when no email is published. |
telefon | Visible phone number | Spot-check format before outreach. |
fax | Fax number when present | Often blank for modern listings. |
facebook | Facebook URL when detected | Validate redirects before enrichment. |
website | External business website | Remove directory or tracking links if needed. |
social_media_links | Other detected social links | Split this field before CRM mapping. |
ueber_uns | About or description text | Review long text before spreadsheet formulas. |
sprachen | Languages when exposed | Treat as optional. |
source_url | GoYellow.de page used for the row | Keep it for audit and deduplication. |
The JSON export includes the extraction intent and the pagination loop. This abbreviated shape shows the parts you will usually edit or inspect:
{
"project": {
"name": "GoYellowde Leads Scraper",
"description": "Scrapes GoYellow.de lead results for the keyword/location example Auto in Berlin."
},
"blocks": [
{
"title": "Navigate",
"config": {
"url": "https://www.goyellow.de/suche/Auto/Berlin"
}
},
{
"title": "Structured Export",
"config": {
"rowSelector": "#uscraper-goyellow-rows .uscraper-lead-row",
"fileName": "goyellow_de_leads_scraper.csv",
"fileMode": "append",
"columns": [
{ "name": "titel", "attribute": "data-titel" },
{ "name": "branche", "attribute": "data-branche" },
{ "name": "telefon", "attribute": "data-telefon" },
{ "name": "website", "attribute": "data-website" },
{ "name": "source_url", "attribute": "data-source-url" }
]
}
},
{
"title": "Element Exists",
"config": {
"selector": "#uscraper-next-page-link[href]"
}
}
]
}
Runbook
How to scrape GoYellow.de business listings step by step
Choose a focused search
Pick one business category and one city. Review the GoYellow.de result page manually and confirm it matches the project scope.
Import the template
Open GoYellow.de Leads Scraper, download the JSON workflow, and import it into UScraper.
Edit the search URL
In Navigate, replace the sample /suche/Auto/Berlin URL with your approved keyword and city path.
Confirm the export path
Open Structured Export, choose the local save folder, keep headers enabled, and decide whether append mode should reuse or extend an existing CSV.
Run a validation page
Stop after the first page, compare several rows against GoYellow.de, and check blanks in email, phone, website, and opening-hours columns.
Let pagination finish
If the validation pass is clean, allow the next-page loop to continue. Keep the source URL column so rows can be audited later.
Common issues and fixes
UScraper vs Octoparse vs Apify for GoYellow.de
If you are comparing a GoYellow.de scraper alternative, choose based on where the workflow should run and who maintains it.
| Option | Good fit | Trade-off |
|---|---|---|
| UScraper | Local desktop app workflow, visible browser validation, CSV-first lead review | You manage the run, pacing, and selector validation. |
| Octoparse GoYellow template | No-code hosted or desktop-style template workflows | Better when your team already uses Octoparse operations. |
| Apify GoYellow actors | API-driven runs, cloud datasets, Python or JavaScript integration | Better for developer pipelines, but less spreadsheet-first. |
For a sales or agency workflow, the UScraper template is usually the simplest path when the immediate goal is scrape GoYellow.de business listings to CSV, review the rows locally, then decide what belongs in the CRM.
FAQ
GoYellow.de scraper FAQ
Next steps
Download the maintained workflow from GoYellow.de Leads Scraper, run one validation page, and keep the exported source_url column with every row. For adjacent workflows, browse the UScraper template library or compare related tutorials in the UScraper blog.