
Congress Stock Trades Scraper
scrape.ly/store/querystone/congress-trades-scraperNewsBusiness
3 monthly users

Scrape gelbeseiten.de business listings by keyword and city or URL. Get name, phone, email, website, address, coordinates, rating, reviews, opening hours, categories and services. Built for German B2B lead generation.
Turn any Gelbe Seiten search into a clean list of German business leads. Type a keyword (Was) and a city or postcode (Wo), or paste gelbeseiten.de URLs, and get each business's name, phone, email, website, full address, coordinates, rating, review count, opening hours, categories and services. No login, no coding, and you only pay for the businesses you get.
Zahnarzt) and one or more locations (for example Berlin, München or a postcode like 50667). Leave the location empty to search all of Germany. Or paste gelbeseiten.de search, category or business URLs.| Field | Type | Description |
|---|---|---|
searchTerms | array | Keywords (Was), e.g. ["Zahnarzt", "Kieferorthopäde"] |
locations | array | Cities, districts or postcodes (Wo). Empty = all of Germany |
startUrls | array | gelbeseiten.de search (/suche/zahnarzt/berlin), category (/branchen/friseur/hamburg) or business (/gsbiz/...) URLs |
maxItems | integer | Max businesses per search term + location or URL (default 20, 0 = all) |
sort | string | relevanz (best match), bewertung (rating) or entfernung (distance) |
radiusKm | integer | Only businesses within this many km of the location |
minRating | integer | Keep only businesses rated at least this many stars |
onlyWithEmail / onlyWithWebsite | boolean | Skip businesses without an email / website |
includeDetails | boolean | Open each business page for email, coordinates, hours and more (default on) |
includeReviews | boolean | Add the reviews shown on the business page (default off) |
proxyConfiguration | object | Proxy settings. German residential by default |
{
"searchTerms": ["Zahnarzt"],
"locations": ["Berlin"],
"maxItems": 20,
"sort": "relevanz",
"includeDetails": true,
"includeReviews": false
}
| Field | Description |
|---|---|
name | Business name |
url, gelbeSeitenId, listingId | Gelbe Seiten business page and IDs |
category, categories | Main category (Branche) and all categories |
phone, extraPhones, fax | Main phone, other numbers and fax |
email | Email address, when published |
website, otherLinks, socialLinks | Website, extra links and social profiles (Facebook, Instagram, Xing, ...) |
address, street, zip, city, district, country | Full address and its parts |
latitude, longitude | Coordinates |
distance | Distance from the searched location |
rating, reviewCount | Star rating (0-5) and number of reviews |
openStatus | Open-now text from the search list |
openingHours, hours | Opening hours as schema.org strings and as a day-by-day table |
description, services, features | About text, services (Leistungsumfang) and features like accessibility or parking |
logo, images | Logo and photo URLs |
reviews | Review author, rating, date and text (with includeReviews) |
lastUpdated | When the listing was last updated on Gelbe Seiten |
searchTerm, searchLocation, searchUrl, position | Which search found the business and where it ranked |
detailsLoaded, scrapedAt | Whether the business page was read, and when |
Example (sample data, shortened):
{
"name": "Zahnarztpraxis Dr. Muster",
"url": "https://www.gelbeseiten.de/gsbiz/00000000-0000-0000-0000-000000000000",
"category": "Zahnärzte",
"categories": ["Zahnärzte"],
"phone": "030 1 23 45 67",
"fax": "030 1 23 45 68",
"email": "praxis@example.de",
"website": "https://www.example.de",
"socialLinks": ["https://www.instagram.com/example"],
"address": "Musterstr. 1, 10115 Berlin",
"street": "Musterstr. 1",
"zip": "10115",
"city": "Berlin",
"district": "Mitte",
"country": "DE",
"latitude": 52.5321,
"longitude": 13.3849,
"distance": "1,4 km",
"rating": 4.8,
"reviewCount": 35,
"openingHours": ["Mo 08:00-18:00", "Di 08:00-18:00", "Mi 08:00-13:00"],
"hours": {"Monday": "08:00-18:00", "Tuesday": "08:00-18:00", "Wednesday": "08:00-13:00", "Saturday": "Closed"},
"services": ["Bleaching", "Zahnreinigung", "Implantologie"],
"features": ["Barrierefrei", "Parkplätze"],
"lastUpdated": "2026-08-13",
"searchTerm": "Zahnarzt",
"searchLocation": "Berlin",
"position": 1,
"detailsLoaded": true,
"scrapedAt": "2026-10-15T08:00:00+00:00"
}
You pay $1.30 per 1,000 businesses ($0.0013 each), plus a little platform usage (compute and proxy traffic, about 25 KB per business), which is usually a few cents per 1,000 businesses. For example, 1,000 dentists with full details cost about $1.30 in results plus a few cents of usage. Businesses removed by your filters are not charged. You can cap the cost of any run with the maximum total charge setting.
Is it legal to scrape Gelbe Seiten? The actor only reads public business listings that anyone can see without logging in. You are responsible for how you use the data, especially for marketing under GDPR and German UWG rules (for example, cold emails usually need prior consent).
Do I need a login or my own proxy? No. No account is needed and the proxy is built in: German residential by default, because Gelbe Seiten blocks most datacenter IPs on business pages. If you pick datacenter and it gets blocked, the run switches to residential by itself.
How many results can I get?
As many as Gelbe Seiten lists for the search. A run logs how many businesses are listed for each search, and 0 as the limit scrapes them all. Large searches such as "Restaurant" across Germany list tens of thousands of businesses.
Why is a field empty?
Gelbe Seiten only shows what the business published. Roughly half of listings show an email, most show a phone and website, and ratings only exist for businesses with reviews. If a business page fails to load, the row still has the search-list fields and detailsLoaded is false.
Can I schedule it or use the API? Yes. Schedule runs in the console, or start runs and download results through the API in JSON, CSV, Excel or HTML.
Can I search the whole country?
Yes. Leave Locations empty (or use bundesweit) to search all of Germany.
lastUpdated field shows when the listing last changed.Every field below can be set in the run form, passed through the API, or saved as a task. Unset fields fall back to the defaults shown.
searchTermsarrayOptionalSearch terms (Was)
What to search for on Gelbe Seiten, e.g. 'Zahnarzt', 'Steuerberater', 'Restaurant', 'Elektriker'. Each term is searched in every location below.
locationsarrayOptionalLocations (Wo)
German cities, districts or postcodes (PLZ), e.g. 'Berlin', 'München', '50667'. Leave empty to search all of Germany.
startUrlsarrayOptionalGelbe Seiten URLs
Optional. Search URLs (https://www.gelbeseiten.de/suche/zahnarzt/berlin), category URLs (https://www.gelbeseiten.de/branchen/friseur/hamburg) or business pages (https://www.gelbeseiten.de/gsbiz/...).
maxItemsintegerOptionaldefault 20Max results per search
Stop each search term + location (or URL) after this many businesses. 0 means all listings.
sortenumOptionaldefault "relevanz"Sort by
Order of the search results.
radiusKmintegerOptionalRadius (km)
Only businesses within this distance of the location. Empty or 0 uses the Gelbe Seiten default area.
minRatingintegerOptionalMinimum rating
Only keep businesses with at least this star rating (1-5). Businesses without ratings are skipped when set.
onlyWithEmailbooleanOptionaldefault falseOnly businesses with email
Skip businesses that do not publish an email address. Skipped businesses are not charged.
onlyWithWebsitebooleanOptionaldefault falseOnly businesses with website
Skip businesses without a website.
includeDetailsbooleanOptionaldefault trueOpen business pages
Open each business page for email, coordinates, full opening hours, fax, social links, all categories, services and description. Turn off for faster, list-only results (phone, website, address, rating).
includeReviewsbooleanOptionaldefault falseInclude reviews
Add the reviews shown on each business page (author, rating, date, text). Needs 'Open business pages'.
proxyConfigurationobjectOptionaldefault {"useScrapelyProxy":true,"scrapelyProxyGroups":["RESIDENTIA…Proxy configuration
Gelbe Seiten blocks most datacenter IPs on business pages, so German residential proxy is the default. It is cheap here: about 25 KB per business.
Every run writes its results to a dataset. Preview it in the dashboard, then export it or read it through the API.
| Field | Type | Description |
|---|---|---|
| logo | any | Logo |
| name | any | Name |
| phone | any | Phone |
| any | ||
| website | any | Website |
| address | any | Address |
| category | any | Category |
| rating | any | Rating |
| reviewCount | any | Reviews |
| openStatus | any | Open now |
| latitude | any | Latitude |
| longitude | any | Longitude |
| url | any | Gelbe Seiten URL |
You pay for the events the actor reports, such as each result or page it produces. Platform usage is included in the event prices.
| Event | Charged when | Price |
|---|---|---|
| Business | Charged once for each business saved to the dataset. | $0.0013 |
Run this actor from your own code. Swap in your API token and the examples work as-is.
import { ScrapelyClient } from 'scrapely-client'
const client = new ScrapelyClient({ token: process.env.SCRAPELY_TOKEN })
// Start the actor and wait for the run to finish.
const run = await client.actor('cornerledger/gelbe-seiten-scraper').call({
"searchTerms": [
"Zahnarzt"
],
"locations": [
"Berlin"
],
"maxItems": 20,
"proxyConfiguration": {
"useScrapelyProxy": true,
"scrapelyProxyGroups": [
"RESIDENTIAL"
],
"scrapelyProxyCountry": "DE"
}
})
// Read the dataset the run produced.
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)Tokens live in your account settings. Keep them server-side: a token carries the full permissions of your account.
Connect the Scrape.ly MCP server once and your agent can run this actor as a tool. Pick your tool:
Fetch scrape.ly/agents.md and run cornerledger/gelbe-seiten-scraperPaste into Claude Code, Codex, Cursor or any AI agent. It signs you in once in the browser.
{
"mcpServers": {
"scrapely": {
"url": "https://api.scrape.ly/mcp?tools=actors,runs,storage,docs&actors=cornerledger/gelbe-seiten-scraper"
}
}
}No key in the file: your client opens the browser to sign you in the first time it connects.
Inputs the developer prepared for common jobs. Open one to see its input, then copy it to your account to run it as-is or adjust it.
Search Gelbe Seiten by trade and city.
Businesses with a website and 4+ stars, sorted by rating.
Business pages with details and customer reviews.
Businesses from a pasted Gelbe Seiten search link.
Scrape.ly gives you the infrastructure, the tooling, and the team to extract, process, and operationalize web data at any scale. Setup takes minutes. The advantage lasts forever.