PanoramaFirm Scraper: Polish Business Phones & Emails

From The Mine Works, makers of Threads Scraper and B2B Leads Finder, with over 140,000 runs across 170+ public actors.

Type a trade in Polish and a place in Poland, for example hydraulik in Warszawa, and get one row per business that PanoramaFirm.pl lists: name, phone in international format, address with postcode, coordinates, Warsaw district, website, rating and review count, and the link to its PanoramaFirm page. Turn on Find emails and the actor adds the email address the business published on PanoramaFirm, or else one read from its own website. Open each business page and you also get the Polish NIP tax number.

Why choose this actor?

• Most emails come straight from the directory, charged only when delivered. PanoramaFirm keeps the business's email in each result card, so in our proof run (hydraulik in Warszawa, 28 Sep 2026) 16 of 20 businesses came back with an email without visiting a single company website. The other 4 had no email and no website, and were charged as businesses only.
• The NIP tax number for every business page we opened. With business pages on, our 1 Oct 2026 run of 25 dentists in Kraków returned the NIP for all 25, plus 19 emails, in 17 seconds. Match it against Poland's business registers or your CRM.
• No nationwide rows billed under a town's name. PanoramaFirm quietly drops a place it does not know (a postcode, a typo) and searches all of Poland instead. The actor spots that and returns nothing for that search, with a note in the run summary. No account, cookies or API key.

Part of The Mine Works Leads and business directories family: B2B Leads Finder, Skip Trace Lookup, Google Maps Email Scraper, JustDial Scraper, 2GIS Places Scraper, IndiaMART Scraper.

Try it in one minute

Paste this input into the JSON tab and press Start. It returns the first 10 plumbers PanoramaFirm lists for Warsaw, without emails, in a few seconds:

{
  "queries": ["hydraulik"],
  "locations": ["Warszawa"],
  "maxResultsPerSearch": 10
}

You can say what you want in two ways, and mix them in one run:

• Queries and locations (queries, locations): Polish trade words as you would type them on the site, such as hydraulik, elektryk, dentysta, fryzjer or restauracja, and a city, county, voivodeship or Warsaw district (Kraków, mazowieckie, Mokotów). Every query is searched in every location. Leave locations empty to search the whole country. Postcodes are not recognised by the site.
• Search pages (startUrls): a PanoramaFirm results page copied from your browser, either https://panoramafirm.pl/szukaj?what=hydraulik&where=Warszawa or the short form the site redirects to, such as https://panoramafirm.pl/hydraulik/mazowieckie,,warszawa.

API and agent callers can also use other common field names: query, keyword, keywords or searchTerms for queries, location, where or city for locations, urls for search pages, maxResults or maxItems for the limit, and sort for sortBy.

Apify's free plan includes $5 of credit every month, which covers about 2,400 businesses at this actor's Free plan price with emails off ($0.002 a business plus $0.005 a run), or about 190 businesses with emails on at the rate of our proof run, about 150 of them with an email.

Copy to your AI assistant

themineworks/panoramafirm-business-email-scraper on Apify. Searches PanoramaFirm.pl, the Polish business directory, by Polish trade word and place and returns one row per business with name, phones, address, postcode, coordinates, Warsaw district, website, rating and review count, plus an optional email (usually published on PanoramaFirm itself) and, with business pages on, the NIP tax number. Call ApifyClient("TOKEN").actor("themineworks/panoramafirm-business-email-scraper").call(run_input={"queries": ["hydraulik"], "locations": ["Warszawa"], "maxResultsPerSearch": 50, "includeEmails": true}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: queries (Polish trade words such as "hydraulik") unless startUrls is given. Optional: locations (city, county, voivodeship or Warsaw district; empty = all of Poland), startUrls (panoramafirm.pl search pages), maxResultsPerSearch (integer 1 to 1000, default 30), includeEmails (default false), includeDetails (default false), sortBy (popularity, rating, az or za; default popularity), openNow (default false), verifyEmailDomain (default true), allowUnblockerFallback (default true). Rows with _type "info" are run notes, never billed. Full spec: GET https://api.apify.com/v2/acts/themineworks~panoramafirm-business-email-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations

Key features

• Up to 1,000 businesses per search, up to 300 searches per run. PanoramaFirm shows 25 businesses a page and serves up to 200 pages (5,000 businesses) for one search; the actor reads up to 1,000 of them per search, and the run summary repeats the count the site reports (998 dentists in Kraków and 114 plumbers in Warsaw in our runs). Each run takes up to 50 queries times 50 locations, capped at 300 searches.
• 28 fields per business: listing id and PanoramaFirm link, name, category, every phone, the address split into street, postcode and town, coordinates, Warsaw district, distance from the searched place when the site shows one, website, rating and review count, description and NIP from the business page, the email and where it was found, and the search that found the row.
• Contact data from the results page itself. PanoramaFirm keeps phone, website and email in each result card, so a run without business pages makes one request per 25 businesses.
• Emails from two places. First the address the business published on PanoramaFirm, then its own website: homepage, then the Kontakt and legal pages it links to, then /kontakt, /o-nas, /o-firmie and /polityka-prywatnosci, at most 5 pages and 20 seconds per site. Website addresses are kept only on the business's own domain or an ordinary provider such as gmail.com, wp.pl, o2.pl, interia.pl or onet.pl. Every address, PanoramaFirm's own included, goes through a mail server check. Up to 5 addresses per row, best first.
• The site's own sort and filter. sortBy takes the site's orders (most popular, highest rated, A to Z, Z to A), and openNow keeps only businesses the site marks as open at the moment of the run.
• Plain HTTP at 512 MB, no browser. Every run writes a summary to the OUTPUT record in its key-value store: for each search the status (ok, no_results or blocked), the count the site reports, pages read and refused, connection attempts, and where the emails came from.

How to use it

Basic: one trade in one city

{
  "queries": ["hydraulik"],
  "locations": ["Warszawa"],
  "maxResultsPerSearch": 114
}

PanoramaFirm reported 114 plumbers for Warsaw on 28 Sep 2026, so this reads all 5 pages. The word must be Polish: the English plumber found 2 businesses in Warsaw.

Several trades in several cities

Every query runs in every location, so this is six searches:

{
  "queries": ["elektryk", "hydraulik", "dekarz"],
  "locations": ["Wrocław", "Poznań"],
  "maxResultsPerSearch": 200
}

A business found by two of the searches under the same PanoramaFirm id is delivered once and charged once. Two searches run at a time.

Best rated businesses first

When you only need a short list, sort by rating so businesses with reviews come first:

{
  "queries": ["fryzjer"],
  "locations": ["Gdańsk"],
  "maxResultsPerSearch": 25,
  "sortBy": "rating"
}

sortBy changes which businesses land on the first pages, so with a small maxResultsPerSearch it changes which ones you get.

NIP numbers and emails for a B2B list

{
  "queries": ["dentysta"],
  "locations": ["Kraków"],
  "maxResultsPerSearch": 25,
  "includeEmails": true,
  "includeDetails": true
}

This is the input of our 1 Oct 2026 run: 25 businesses with 25 business pages in 17 seconds, every row with its NIP (tax_id), 19 with an email (17 from PanoramaFirm, 2 from the business's website) and 13 with a longer description. Business pages cost nothing extra.

Monthly refresh on a schedule

Save any of the inputs above as a task, then in Apify Console open Schedules, add a schedule (for example the first of every month) and pick the task. Each scheduled run is billed like a manual one, and the schedule itself is free. The actor has no "only new businesses" mode, so compare listing_id with your last export to find the newcomers.

Read a search you already set up on the site

{
  "startUrls": [
    { "url": "https://panoramafirm.pl/szukaj?what=hydraulik&where=Warszawa" }
  ],
  "maxResultsPerSearch": 50
}

Each pasted page is read from its first page on, with the same limits and charges as a typed search. Business pages (whose address ends in .html after the place) are not read as searches.

Input parameters

Parameter	Type	Default	What it does
queries	array of strings	none (prefilled with hydraulik)	Polish trade words to search, one per line. Up to 50. Needed unless you give startUrls.
locations	array of strings	empty (prefilled with Warszawa)	Cities, counties, voivodeships or Warsaw districts, one per line. Every query is searched in every location. Empty searches all of Poland. Up to 50.
startUrls	array	empty	PanoramaFirm search result pages, read instead of or as well as the queries.
maxResultsPerSearch	integer	30	Most businesses per query and location, 1 to 1,000. The site shows 25 per page.
includeEmails	boolean	false	Add each business's email: the address published on PanoramaFirm first, then its website. Charged only for rows that come back with one.
includeDetails	boolean	false	Also open each business's own PanoramaFirm page, for the NIP tax number and, where the business wrote one, a longer description. No extra charge, slower.
sortBy	string	popularity	popularity (the site's default), rating (highest rated first), az or za (alphabetical).
openNow	boolean	false	Keep only businesses the site marks as open at the time of the run. Drastic: hydraulik in Warszawa went from 114 to 1 in our test, and businesses without published hours are left out.
verifyEmailDomain	boolean	true	Keep an email only when its domain can receive mail. Applies to PanoramaFirm's and website emails alike.
allowUnblockerFallback	boolean	true	When a search page is refused several times over the fast connection, retry it through Apify's unblocking proxy. Included in the price. Turn off to report such pages as refused instead.

Give at least one query or one search page. A run with neither writes a note row and stops; the $0.005 start fee still applies.

What data do you get?

One row per business. Fields with no value are left out of the row rather than sent as empty.

The business

• listing_id (PanoramaFirm's id, such as company_11792529_3660), listing_url, name, categories (the category on the card, such as Hydraulicy), rating (when the business has reviews) and review_count (0 when it has none), description (from the business page, when the business wrote one)

Contact

• phone (the first number) and phones (all of them), in international format such as +48 519 381 179; website, with utm_, fbclid, gclid and mc_ tracking parameters removed

Address and map

• address (one line), street, postal_code (such as 02-486), city, country (always PL), latitude, longitude, district (the Warsaw borough, for addresses in Warsaw only) and distance_km (only when the card shows a distance from the place you searched)

Tax number (with includeDetails on)

• tax_id, the Polish NIP, such as 6772202623

Email (with includeEmails on)

• email (the best address), emails (up to 5, best first), email_source (directory or website) and email_source_url (the PanoramaFirm page, or the website page it was read from)

Search context

• source_site (panoramafirm.pl), search_query, search_location, scraped_at

A few things to know about the fields:

• A small town is filled with businesses from farther away. When a place has few matches, PanoramaFirm adds the nearest businesses of neighbouring towns and counts them in its total; those cards carry distance_km and their own city. A paid top card can show a distance too: the first row of our Warsaw proof run was a business in Kobyłka, 19 km away.
• A village address has no street. Addresses like 05-500 Mysiadło 10E are split into postcode and town only.
• One business can have two PanoramaFirm ids, for a second registration or a second trade. The actor merges the two when they appear on the same page; in separate searches both ids can come back.
• Opening hours come only from the business page, and none of the 25 Kraków business pages in our 1 Oct 2026 run had any.
• Ratings are the average and the count only, not the review texts, and only for businesses with at least one review.

Fill rates in the proof run (20 businesses, emails on): phone 20, email 16, coordinates 18, district 17, website 9, rating 6.

Stable fields for automations

These fields were present in every one of 84 business rows across the proof run, our 1 Oct 2026 Kraków run and the result cards saved for our tests (including a small town search filled from farther away), and their names will not change:

Field	What it holds
listing_id	PanoramaFirm's id for the business listing
listing_url	Link to the business's page on panoramafirm.pl
name	Business name as listed
categories	The category on the card, as a list
address	The address on one line, as the card shows it
postal_code	Polish postcode, such as 02-486
city	Town as the card gives it, sometimes with the city district attached (Kraków Bronowice); in Warsaw the borough goes to district
country	Always PL
review_count	Number of reviews, 0 when there are none
source_site	Always panoramafirm.pl
search_query	The query or pasted search that found the row
scraped_at	When the row was read (ISO 8601)

search_location is present whenever the search had a place. phone was missing on 5 of the 25 Kraków rows and street on village addresses, so test for them before you rely on them.

Output examples

Real rows, trimmed where marked. From the proof run on 28 Sep 2026 (hydraulik in Warszawa, emails on), a company with its email on PanoramaFirm and its Warsaw borough (complete row):

{
  "listing_id": "company_11792529_3660",
  "listing_url": "https://panoramafirm.pl/mazowieckie,,warszawa,w%C5%82ochy,al._jerozolimskie,214/aries_sp._z_o.o.-alnabi_fhm.html",
  "name": "Aries Sp. z o.o.",
  "categories": ["Hydraulicy"],
  "phone": "+48 519 381 179",
  "phones": ["+48 519 381 179"],
  "address": "Al. Jerozolimskie 214, 02-486 Warszawa Włochy",
  "street": "Al. Jerozolimskie 214",
  "postal_code": "02-486",
  "city": "Warszawa",
  "country": "PL",
  "latitude": 52.19027,
  "longitude": 20.91825,
  "email": "ariesspzoo@gmail.com",
  "emails": ["ariesspzoo@gmail.com"],
  "email_source": "directory",
  "email_source_url": "https://panoramafirm.pl/mazowieckie,,warszawa,w%C5%82ochy,al._jerozolimskie,214/aries_sp._z_o.o.-alnabi_fhm.html",
  "review_count": 0,
  "district": "Włochy",
  "source_site": "panoramafirm.pl",
  "search_query": "hydraulik",
  "search_location": "Warszawa",
  "scraped_at": "2026-09-28T12:46:42.907Z"
}

From the same run, a company with 55 reviews but no email and no website on PanoramaFirm, charged as a business only (trimmed):

{
  "listing_id": "company_16228795_3660",
  "name": "Al-Mat Sp. z o.o.",
  "categories": ["Hydraulicy"],
  "phone": "+48 606 840 400",
  "address": "ul. Spedycyjna 24 lok. 1.28, 03-191 Warszawa",
  "postal_code": "03-191",
  "city": "Warszawa",
  "rating": 3.4,
  "review_count": 55
}

From our 1 Oct 2026 run with business pages on (dentysta in Kraków), a clinic with its NIP, description, rating and email (complete row):

{
  "listing_id": "company_121972343_370",
  "listing_url": "https://panoramafirm.pl/ma%C5%82opolskie,,krak%C3%B3w,bronowice,krakus%C3%B3w,1c/stomatologia_steczko_sp._z_o.o.-sgsrmy_sj.html",
  "name": "Stomatologia Steczko Sp. z o.o.",
  "categories": ["Stomatolodzy i protetycy"],
  "phone": "+48 601 397 681",
  "phones": ["+48 601 397 681"],
  "address": "ul. Krakusów 1c, 30-092 Kraków Bronowice",
  "street": "ul. Krakusów 1c",
  "postal_code": "30-092",
  "city": "Kraków Bronowice",
  "country": "PL",
  "website": "https://www.steczkodentysta.pl",
  "email": "biuro@steczkodentysta.pl",
  "emails": ["biuro@steczkodentysta.pl"],
  "email_source": "directory",
  "email_source_url": "https://panoramafirm.pl/ma%C5%82opolskie,,krak%C3%B3w,bronowice,krakus%C3%B3w,1c/stomatologia_steczko_sp._z_o.o.-sgsrmy_sj.html",
  "rating": 5,
  "review_count": 102,
  "description": "Klinika stomatologiczna Steczko znajduje się w Krakowie. Swoje usługi świadczymy już od 1999 roku. Właścicielami są Anna i Wacław Steczko.",
  "tax_id": "6772202623",
  "source_site": "panoramafirm.pl",
  "search_query": "dentysta",
  "search_location": "Kraków",
  "scraped_at": "2026-10-01T13:54:56.332Z"
}

The note row at the end of the run (never charged; filter on _type to drop it), trimmed:

{
  "_type": "info",
  "delivered": 20,
  "message": "20 businesses delivered. This row is informational: it is never billed.",
  "scraped_at": "2026-09-28T12:46:46.280Z"
}

Pricing

You pay per business delivered to your dataset, plus a flat start fee per run. An email is a second, separate charge, made only for rows that come back with one. The fast connection and the unblocking proxy fallback are included.

Event	Free plan	Starter (Bronze)	Scale (Silver)	Business (Gold) and above
Business delivered (listing-scraped), per business	$0.002	$0.0017	$0.0014	$0.001
Business delivered, per 1,000	$2.00	$1.70	$1.40	$1.00
Email found (email-found), per email	$0.03	$0.025	$0.02	$0.015
Email found, per 1,000	$30	$25	$20	$15
Run start (run-start), once per run	$0.005	$0.005	$0.005	$0.005

The start fee is our own run-start event: a flat $0.005 once per run, whatever memory you choose. It is not Apify's per GB start fee, and it is charged on every run, including a run that finds nothing. These prices took effect on 28 Sep 2026, and no change is scheduled as of 1 Oct 2026. The Pricing tab always shows the rate for your own plan; if this table and the Pricing tab ever disagree, the Pricing tab is right.

What a real job costs. 1,000 businesses with emails off cost $2.00 plus $0.005 on the Free plan, and $1.00 plus $0.005 on Business. With emails on, at the rates of our two runs (16 of 20 and 19 of 25), 1,000 businesses bring about 780 emails: about $23.40 more on Free and $11.70 more on Business. Turn emails on only for the searches where you need them; business pages cost nothing extra.

Never charged:

• search pages the site refused, and the retries through the unblocking proxy;
• a business already delivered by another search in the same run, under the same PanoramaFirm id;
• a search for a place PanoramaFirm does not know, which it would have widened to all of Poland (nothing is delivered);
• business pages and websites that were opened but gave no email (the row is charged as a business only);
• an email address already charged earlier in the same run, such as the shared inbox of a chain's branches (it is still delivered on every row);
• the note row and the OUTPUT run summary.

To cap what a run can cost, set a maximum total charge in the run options. The actor stops before a business the budget cannot pay for, and when the budget covers a business but not its email, the row is delivered without the email and the email is not charged.

FAQ

What is PanoramaFirm.pl?

One of Poland's largest business directories, run by WeNet. It lists tradespeople, shops, clinics, restaurants, professionals and companies across Poland, with phone, address, website and, for most listings, an email.

How many businesses can I get?

Up to 1,000 per search and up to 300 searches per run. The site itself serves at most 200 pages (5,000 businesses) for one search, so a nationwide trade such as restauracja (22,743 results on 28 Sep 2026) can never be read in full from one search: split it by city or voivodeship. A run stops cleanly before its timeout (one hour by default) and keeps everything delivered so far, so raise the timeout in the run options for very large runs.

What do I type into Queries?

The Polish trade word as you would type it on PanoramaFirm.pl: hydraulik, elektryk, dentysta, fryzjer, restauracja, prawnik. English words find almost nothing (plumber found 2 businesses in Warsaw against 114 for hydraulik). Close variants are different words to the site: hydraulika is narrower than hydraulik.

What do I type into Locations?

A city (Kraków, Wrocław), a county, a voivodeship (mazowieckie, małopolskie) or a Warsaw district on its own (Mokotów). Diacritics are optional. Postcodes are not recognised: a place the site does not know is dropped by the site, which then searches all of Poland, so the actor stops that search and says so in the run summary instead of delivering nationwide rows.

Why are some businesses outside the place I searched?

For a small town with few matches, PanoramaFirm itself adds the nearest businesses from neighbouring towns and counts them in its total. Those rows carry distance_km and their own city, so filter on them if you need the exact town only. A very small or rural place can return only distant businesses.

How fresh is the data?

Every run reads the site live; nothing comes from a cache. scraped_at on each row says when it was read.

Do I need a PanoramaFirm account, cookies or an API key?

No. The actor reads the public pages any visitor sees, without signing in. There is nothing of yours to connect.

Do I need to set up a proxy?

No. The actor uses a fast connection that looks like a normal Chrome browser, through Apify's datacenter proxies, and PanoramaFirm answered every search and business page that way in our 1 Oct 2026 runs. A refused search page is retried through Apify's unblocking proxy, included in the price; refused pages are listed in the run summary and never charged.

Will every business have an email?

No, but most do: 16 of 20 in the Warsaw proof run and 19 of 25 in the Kraków run, nearly all published on PanoramaFirm itself. For a card without an email, the actor tries the business's own website. A business with neither an email on PanoramaFirm nor a website gives none. The actor never guesses an address from a name, and you pay nothing extra for a row without one.

Which pages does it read?

Search pages (/szukaj?what=...&where=... or the site's short form) and, with includeDetails on, business pages. PanoramaFirm's robots.txt, read again on 1 Oct 2026, is Allow: / for every crawler.

Can I get only the new businesses each month?

There is no "only new" mode in this actor. Schedule the same input and compare listing_id with your last export.

Which formats can I export?

JSON, CSV, Excel, XML, HTML table and RSS from the dataset page in Apify Console, or through the Apify API.

Can I use it from Claude, ChatGPT or another AI agent?

• Connector URL: https://mcp.apify.com/?tools=themineworks/panoramafirm-business-email-scraper.
• Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
• ChatGPT: developer mode, add an MCP connector with the URL, sign in with Apify.
• Cursor or VS Code: add it as an HTTP MCP server with that URL.
• Claude Code: claude mcp add -t http panoramafirm-business-email-scraper "https://mcp.apify.com/?tools=themineworks/panoramafirm-business-email-scraper".

Is it legal to scrape PanoramaFirm.pl?

The actor collects only publicly visible business listings and never signs in. Business contact details are still personal data when they identify a person, and many Polish listings are sole traders under their own name, so how you store and use them is your responsibility: follow the site's terms and the GDPR (RODO), and where you send marketing messages also Poland's electronic communications rules, which require prior consent for commercial email (and CAN-SPAM or the CCPA for contacts in the US). This is general information, not legal advice. The actor is an independent tool, not affiliated with or endorsed by PanoramaFirm or WeNet.

Integrations

• Google Sheets: send each run's dataset to a sheet with Apify's Google Sheets integration.
• Make, Zapier and n8n: start runs and receive the businesses in your workflows.
• Webhooks: get a call when a run finishes, for example to load new rows into your CRM.
• API: start runs and read datasets from any language with the Apify API or the Python and JavaScript clients.
• MCP clients: Claude, ChatGPT and other agents through Apify's MCP server.

More from The Mine Works

Leads and business directories

• B2B Leads Finder
• Skip Trace Lookup
• Google Maps Email Scraper
• JustDial Scraper
• 2GIS Places Scraper
• IndiaMART Scraper
• Yandex Maps Scraper
• Contact Details Scraper
• US Business Registry
• Google Maps Scraper
• Yellow Pages Scraper
• Lead Generation MCP

Social media and video

• Threads Scraper
• Reddit Scraper
• Threads Search Scraper
• Instagram Profile Scraper

Marketing, SEO and reviews

• Facebook Ad Library Scraper
• Similarweb Scraper
• Google Ads Transparency Scraper
• Google News Scraper

LinkedIn

• LinkedIn Company Scraper
• LinkedIn Post Scraper
• LinkedIn Employees Scraper
• LinkedIn Profile Scraper

Real estate

• Zillow Rentals Scraper
• Zillow Sold Comps Scraper
• Housing.com Scraper
• India Real Estate MCP

Science, health and government data

• CourtListener Scraper
• data.gov.in Scraper
• Socrata Open Data Scraper
• Academic Research MCP

Jobs and hiring

• Foundit Monster India Jobs
• Hirist Jobs Scraper
• India Jobs MCP
• Naukri Jobs Scraper

E-commerce and marketplaces

• Ozon.ru Scraper
• ⭐ Amazon Reviews Scraper
• Amazon Product Scraper
• Carsales.com.au Scraper

Company and business data

• Company Domain Finder
• GST Taxpayer Lookup
• World Bank Trade Scraper
• Company KYB Resolver

Food and local services

• NoBroker Scraper
• Swiggy Restaurant Scraper
• Zomato Scraper

Developer and AI tools

• Website to Markdown Crawler
• GitHub Skill Finder
• GitHub Repo Scraper
• GitHub Trending Scraper

More tools

• Tennis Match & Player Data Scraper
• Google Hotels Prices Scraper
• LandWatch Scraper

Support

Found a problem or need a field? Open an issue on the actor's Issues tab and we will answer there. For a new source or a custom build, email dmineworks@gmail.com.

PanoramaFirm Scraper turns a Polish trade word and a place into rows of businesses with phone, address, coordinates and, when you want them, the email PanoramaFirm publishes and the company's NIP.