# PanoramaFirm Business Directory Scraper (`crawlerbros/panoramafirm-scraper`) Actor Scrape PanoramaFirm.pl - Poland's major business directory. Search businesses by category (branża) and city, or fetch full profile pages by URL: address, phone, website, email, opening hours, ratings/reviews, NIP, and GPS coordinates. - **URL**: https://apify.com/crawlerbros/panoramafirm-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## PanoramaFirm Business Directory Scraper Scrape [PanoramaFirm.pl](https://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 ```json { "mode": "search", "category": "hydraulicy", "city": "warszawa", "fetchDetails": true, "maxItems": 100 } ```` #### Example: highly rated restaurants in Kraków, listing-only (fast) ```json { "mode": "search", "category": "restauracje", "city": "krakow", "fetchDetails": false, "minRating": 4, "maxItems": 200 } ``` #### Example: re-scrape specific business profiles ```json { "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. # Actor input Schema ## `mode` (type: `string`): What to fetch. ## `category` (type: `string`): Type of business to search for (mode=search). ## `city` (type: `string`): Restrict results to a city (mode=search). Leave as "Whole Poland" to search the entire country. ## `sort` (type: `string`): How PanoramaFirm should order results before they're scraped. Only affects which businesses are emitted first when `maxItems` truncates the result set. ## `openNowOnly` (type: `boolean`): Only keep businesses PanoramaFirm currently marks as open (based on their published opening hours). ## `profileUrls` (type: `array`): Full PanoramaFirm.pl business profile page URLs to fetch directly. ## `fetchDetails` (type: `boolean`): For mode=search: visit each business's profile page to also collect opening hours, description, NIP, GPS coordinates and full review data. Slower but richer. Turn off for a fast, listing-only scrape. ## `minRating` (type: `integer`): Only keep businesses with a rating at or above this value (1-5). Businesses with no rating yet are always kept unless this is set. ## `maxItems` (type: `integer`): Hard cap on the number of business records emitted. ## `proxyConfiguration` (type: `object`): PanoramaFirm.pl is publicly accessible without a proxy, so this is off by default. It exists only as an optional fallback if a request is ever blocked from your run location. ## Actor input object example ```json { "mode": "search", "category": "hydraulicy", "city": "warszawa", "sort": "popularity", "openNowOnly": false, "profileUrls": [], "fetchDetails": true, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `businesses` (type: `string`): Dataset containing all scraped PanoramaFirm.pl businesses. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "category": "hydraulicy", "city": "warszawa", "sort": "popularity", "openNowOnly": false, "profileUrls": [], "fetchDetails": true, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/panoramafirm-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "category": "hydraulicy", "city": "warszawa", "sort": "popularity", "openNowOnly": False, "profileUrls": [], "fetchDetails": True, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/panoramafirm-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "mode": "search", "category": "hydraulicy", "city": "warszawa", "sort": "popularity", "openNowOnly": false, "profileUrls": [], "fetchDetails": true, "maxItems": 50, "proxyConfiguration": { "useApifyProxy": false } }' | apify call crawlerbros/panoramafirm-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/panoramafirm-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PanoramaFirm Business Directory Scraper", "description": "Scrape PanoramaFirm.pl - Poland's major business directory. Search businesses by category (branża) and city, or fetch full profile pages by URL: address, phone, website, email, opening hours, ratings/reviews, NIP, and GPS coordinates.", "version": "1.0", "x-build-id": "fGpnzBHXLvDczzeJY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~panoramafirm-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-panoramafirm-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~panoramafirm-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-panoramafirm-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~panoramafirm-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-panoramafirm-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "category": { "title": "Business category (branża)", "enum": [ "adwokaci", "doradztwo_prawne", "doradztwo_podatkowe", "biura_rachunkowe", "ksiegowi", "hydraulicy", "elektrycy", "mechanika_samochodowa", "pomoc_drogowa", "myjnie_samochodowe", "dealerzy_i_sprzedaz_samochodow", "brukarstwo", "dachy_i_rynny", "architektura_krajobrazu", "biura_architektoniczne", "budowa_i_wykonczenia_pod_klucz", "chemia_budowlana", "armatura_hydrauliczna", "geodezja", "fryzjerzy_i_salony_fryzjerskie", "salony_kosmetyczne", "stomatolodzy", "dermatolodzy", "dietetycy", "weterynarze", "apteki", "alergolodzy", "chirurdzy", "chirurgia_plastyczna", "ginekolodzy_i_poloznicy", "kardiolodzy", "laryngolodzy", "lekarze_rodzinni", "logopedzi", "restauracje", "catering", "hotele", "biura_podrozy", "kwiaciarnie", "fotografowie", "agencje_marketingowe", "agencje_posrednictwa_pracy", "agencje_ochrony", "banki", "drukarnie_i_poligrafia", "grafika_komputerowa", "serwis_komputerow", "informatycy", "parkingi", "przeprowadzki" ], "type": "string", "description": "Type of business to search for (mode=search).", "default": "hydraulicy" }, "city": { "title": "City", "enum": [ "", "warszawa", "krakow", "lodz", "wroclaw", "poznan", "gdansk", "szczecin", "bydgoszcz", "lublin", "katowice", "bialystok", "gdynia", "czestochowa", "radom", "rzeszow", "torun", "kielce", "gliwice", "zabrze", "olsztyn", "sosnowiec", "bielsko_biala", "bytom", "zielona_gora", "rybnik", "ruda_slaska", "tychy", "opole", "gorzow_wielkopolski", "elblag", "plock", "walbrzych", "wloclawek", "tarnow", "chorzow", "koszalin", "kalisz", "legnica", "grudziadz", "slupsk", "jaworzno", "jastrzebie_zdroj", "nowy_sacz", "jelenia_gora", "siedlce", "myslowice" ], "type": "string", "description": "Restrict results to a city (mode=search). Leave as \"Whole Poland\" to search the entire country.", "default": "warszawa" }, "sort": { "title": "Sort order (mode=search)", "enum": [ "popularity", "rating", "az", "za" ], "type": "string", "description": "How PanoramaFirm should order results before they're scraped. Only affects which businesses are emitted first when `maxItems` truncates the result set.", "default": "popularity" }, "openNowOnly": { "title": "Open now only (mode=search)", "type": "boolean", "description": "Only keep businesses PanoramaFirm currently marks as open (based on their published opening hours).", "default": false }, "profileUrls": { "title": "Business profile URLs (mode=byUrl)", "type": "array", "description": "Full PanoramaFirm.pl business profile page URLs to fetch directly.", "default": [], "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full profile details", "type": "boolean", "description": "For mode=search: visit each business's profile page to also collect opening hours, description, NIP, GPS coordinates and full review data. Slower but richer. Turn off for a fast, listing-only scrape.", "default": true }, "minRating": { "title": "Minimum rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only keep businesses with a rating at or above this value (1-5). Businesses with no rating yet are always kept unless this is set." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of business records emitted.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "PanoramaFirm.pl is publicly accessible without a proxy, so this is off by default. It exists only as an optional fallback if a request is ever blocked from your run location.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```