PanoramaFirm Business Directory Scraper

Scrape PanoramaFirm.pl — one of Poland's largest business directories — to collect verified company data by industry (branża) and city. Get names, addresses, phone numbers, websites, emails, opening hours, ratings & reviews, tax IDs (NIP), gallery/certificate photos, and GPS coordinates for plumbers, lawyers, dentists, restaurants, mechanics, hairdressers, and 40+ other business categories across every major Polish city. No login, no cookies, and no paid proxy required.

What this actor does

• Search by category + city — pick from 50 curated business categories (branże) and 46 major Polish cities, or search the whole country
• Direct profile lookup — feed in specific PanoramaFirm.pl business URLs to re-scrape or enrich them
• Full business profiles — opening hours, tax ID (NIP), GPS coordinates, service descriptions, gallery/certificate photos, and recent customer reviews
• Sort order — order results by popularity, highest rating, or alphabetically (A-Z / Z-A)
• Open now filter — restrict results to businesses currently marked as open
• Rating filter — keep only businesses at or above a minimum star rating
• Polish-language native — correctly handles Polish diacritics (ą, ć, ę, ł, ń, ó, ś, ź, ż) throughout, in both search input and scraped output
• Empty fields are omitted — every record only contains data that was actually found

Output per business

Field	Description
name	Business / trading name
category	Industry category (branża), e.g. Hydraulicy
address	Full street address as listed
city, postalCode, voivodeship	Parsed location details (when available)
phone	Contact phone number
website	Business website URL
email	Contact email address
facebookUrl	Facebook page, when listed
rating, reviewCount	Average star rating (0–5) and number of reviews
reviews[]	Recent customer reviews (author, rating, date, text)
openingHours[]	Weekly opening hours (day, opens, closes), when published
description	Business description
servicesDescription	Detailed products/services offered
serviceArea	Geographic area the business serves
nip	Polish tax identification number
latitude, longitude	GPS coordinates
googleMapsUrl	Direct Google Maps link
logoUrl	Business logo/photo URL
galleryImages[]	Photo/video-thumbnail URLs from the profile's gallery, when published
certificateImages[]	Certificate/qualification image URLs, when published
profileUrl	Canonical PanoramaFirm.pl profile page
companyId	Internal PanoramaFirm listing identifier
recordType, scrapedAt	Record metadata

Input

Field	Type	Default	Description
mode	string	search	search (by category + city) or byUrl (specific profile URLs)
category	select	hydraulicy (Plumbers)	Business category — 50 options, e.g. lawyers, dentists, mechanics, restaurants, hairdressers, electricians, photographers
city	select	warszawa (Warszawa)	City to search, or "Whole Poland"
profileUrls	array	–	Business profile URLs to fetch directly (mode=byUrl)
fetchDetails	boolean	true	Visit each business's profile page for opening hours, description, NIP, GPS coordinates, gallery/certificate photos and reviews. Turn off for a faster, listing-only scrape
sort	select	popularity	Result order: popularity (site default), rating (highest rated first), az/za (alphabetical) — mode=search
openNowOnly	boolean	false	Only keep businesses currently marked as open — mode=search
minRating	integer	–	Only keep businesses rated at or above this value (1–5)
maxItems	integer	50	Hard cap on the number of records returned (1–1000)
proxyConfiguration	object	AUTO	Proxy settings. The site is publicly accessible; this is only used as an automatic fallback

Example: plumbers in Warsaw with full details

{
  "mode": "search",
  "category": "hydraulicy",
  "city": "warszawa",
  "fetchDetails": true,
  "maxItems": 100
}

Example: highly rated restaurants in Kraków, listing-only (fast)

{
  "mode": "search",
  "category": "restauracje",
  "city": "krakow",
  "fetchDetails": false,
  "minRating": 4,
  "maxItems": 200
}

Example: re-scrape specific business profiles

{
  "mode": "byUrl",
  "profileUrls": [
    "https://panoramafirm.pl/mazowieckie,plonski,popielzyn_dolny,14/hyd_bud_pawel_brzeszkiewicz-sbjbzz_fhm.html"
  ]
}

Use cases

• Lead generation — build targeted prospect lists by industry and city for B2B sales outreach
• Market research — analyze business density, pricing signals, and ratings across Polish cities
• Local SEO agencies — audit a client's directory listing and compare against competitors
• Data enrichment — attach verified phone/email/address/NIP to an existing CRM record
• Competitive analysis — track how many competitors operate in a given category and city
• Directory aggregation — mirror or cross-reference Polish business listings for a broader platform

FAQs

Does this require a PanoramaFirm.pl account or API key? No. PanoramaFirm.pl is a public directory. No login, cookies, or API key is needed.

Which cities are supported? 46 major Polish cities are available as a dropdown (Warszawa, Kraków, Łódź, Wrocław, Poznań, Gdańsk, Szczecin, Bydgoszcz, Lublin, Katowice, Białystok, Gdynia, Częstochowa, Radom, Rzeszów, Toruń, Kielce, Gliwice, Zabrze, Olsztyn, Sosnowiec, Bielsko-Biała, Bytom, Zielona Góra, Rybnik, Ruda Śląska, Tychy, Opole, Gorzów Wielkopolski, Elbląg, Płock, Wałbrzych, Włocławek, Tarnów, Chorzów, Koszalin, Kalisz, Legnica, Grudziądz, Słupsk, Jaworzno, Jastrzębie-Zdrój, Nowy Sącz, Jelenia Góra, Siedlce, Mysłowice), plus a "Whole Poland" option to search nationally.

Can I sort results or filter to only businesses open right now? Yes — sort orders results by popularity (default), highest rating, or alphabetically, and openNowOnly restricts to businesses PanoramaFirm currently marks as open. Note that PanoramaFirm's "open now" listing isn't scoped to your chosen category or city as tightly as a normal search, so combining openNowOnly with a narrow category and city can genuinely return zero results — try widening one of the two filters or dropping openNowOnly.

Which business categories are supported? 50 categories spanning legal & financial services, home & construction trades, automotive, medical & health, food & hospitality, and professional/marketing services — including lawyers, plumbers, electricians, dentists, hairdressers, mechanics, restaurants, photographers, and accountants.

What does fetchDetails change? When enabled (default), the actor visits each business's individual profile page to collect opening hours, a tax ID (NIP), GPS coordinates, and reviews — in addition to what's already visible on the search results page. Disabling it returns results faster but with a smaller field set (name, address, phone, website, email, rating).

Why do some businesses have fewer fields than others? Not every business on PanoramaFirm.pl fills in every field (e.g. opening hours or a website). The actor only includes fields that were actually found — it never fabricates placeholder data.

Can I fetch a business I already know the URL for? Yes — use mode: "byUrl" with a list of PanoramaFirm.pl profile URLs.

Is a proxy required? No. PanoramaFirm.pl is accessible without a proxy. The proxyConfiguration input exists only as an automatic fallback and defaults to Apify's free AUTO proxy group.

How current is the data? Data is scraped live from PanoramaFirm.pl at run time, reflecting whatever is currently published on the site.

Is this actor affiliated with PanoramaFirm.pl? No. This is an independent, third-party actor that reads PanoramaFirm.pl's publicly available pages. It is not operated by or affiliated with PanoramaFirm.pl.