{
  "data": {
    "id": "dc8wGb6oVuOO7FFpr",
    "actId": "1XEKfiPTje3qYkrti",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-11-17T15:04:06.584Z",
    "finishedAt": "2026-11-17T15:04:15.793Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 9085,
      "runTimeSecs": 9.085,
      "computeUnits": 0.010094444444444444,
      "imageSizeBytes": 328339968
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "6GwdnIcc2aWR7LzCS",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"PanoramaFirm Business Directory Scraper Input\",\n  \"description\": \"Search PanoramaFirm.pl by category or keyword and Polish location, or fetch search-results and business profile URLs directly.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"Search the directory, or fetch specific PanoramaFirm URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byUrl\"\n      ],\n      \"enumTitles\": [\n        \"Search by category or keyword\",\n        \"Fetch specific PanoramaFirm URLs\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"category\": {\n      \"title\": \"Business category (branża)\",\n      \"type\": \"string\",\n      \"description\": \"Category to browse when `searchTerms` is empty. Pick one of the curated Polish trades.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"adwokaci\",\n        \"doradztwo_prawne\",\n        \"doradztwo_podatkowe\",\n        \"biura_rachunkowe\",\n        \"ksiegowi\",\n        \"hydraulicy\",\n        \"elektrycy\",\n        \"mechanika_samochodowa\",\n        \"pomoc_drogowa\",\n        \"myjnie_samochodowe\",\n        \"dealerzy_i_sprzedaz_samochodow\",\n        \"brukarstwo\",\n        \"dachy_i_rynny\",\n        \"architektura_krajobrazu\",\n        \"biura_architektoniczne\",\n        \"budowa_i_wykonczenia_pod_klucz\",\n        \"chemia_budowlana\",\n        \"armatura_hydrauliczna\",\n        \"geodezja\",\n        \"fryzjerzy_i_salony_fryzjerskie\",\n        \"salony_kosmetyczne\",\n        \"stomatolodzy\",\n        \"dermatolodzy\",\n        \"dietetycy\",\n        \"weterynarze\",\n        \"apteki\",\n        \"alergolodzy\",\n        \"chirurdzy\",\n        \"chirurgia_plastyczna\",\n        \"ginekolodzy_i_poloznicy\",\n        \"kardiolodzy\",\n        \"laryngolodzy\",\n        \"lekarze_rodzinni\",\n        \"logopedzi\",\n        \"restauracje\",\n        \"catering\",\n        \"hotele\",\n        \"biura_podrozy\",\n        \"kwiaciarnie\",\n        \"fotografowie\",\n        \"agencje_marketingowe\",\n        \"agencje_posrednictwa_pracy\",\n        \"agencje_ochrony\",\n        \"banki\",\n        \"drukarnie_i_poligrafia\",\n        \"grafika_komputerowa\",\n        \"serwis_komputerow\",\n        \"informatycy\",\n        \"parkingi\",\n        \"przeprowadzki\"\n      ],\n      \"enumTitles\": [\n        \"Adwokaci (Lawyers)\",\n        \"Doradztwo prawne (Legal consulting)\",\n        \"Doradztwo podatkowe (Tax consulting)\",\n        \"Biura rachunkowe (Accounting offices)\",\n        \"Księgowi (Accountants)\",\n        \"Hydraulicy (Plumbers)\",\n        \"Elektrycy (Electricians)\",\n        \"Mechanika samochodowa (Car mechanics)\",\n        \"Pomoc drogowa (Roadside assistance)\",\n        \"Myjnie samochodowe (Car washes)\",\n        \"Dealerzy i sprzedaż samochodów (Car dealers)\",\n        \"Brukarstwo (Paving)\",\n        \"Dachy i rynny (Roofing & gutters)\",\n        \"Architektura krajobrazu (Landscape architecture)\",\n        \"Biura architektoniczne (Architecture offices)\",\n        \"Budowa i wykończenia pod klucz (Turnkey construction)\",\n        \"Chemia budowlana (Construction chemicals)\",\n        \"Armatura hydrauliczna (Plumbing fixtures)\",\n        \"Geodezja (Surveying)\",\n        \"Fryzjerzy i salony fryzjerskie (Hairdressers)\",\n        \"Salony kosmetyczne (Beauty salons)\",\n        \"Stomatolodzy (Dentists)\",\n        \"Dermatolodzy (Dermatologists)\",\n        \"Dietetycy (Dietitians)\",\n        \"Weterynarze (Veterinarians)\",\n        \"Apteki (Pharmacies)\",\n        \"Alergolodzy (Allergists)\",\n        \"Chirurdzy (Surgeons)\",\n        \"Chirurgia plastyczna (Plastic surgery)\",\n        \"Ginekolodzy i położnicy (Gynecologists)\",\n        \"Kardiolodzy (Cardiologists)\",\n        \"Laryngolodzy (ENT doctors)\",\n        \"Lekarze rodzinni (Family doctors)\",\n        \"Logopedzi (Speech therapists)\",\n        \"Restauracje (Restaurants)\",\n        \"Catering\",\n        \"Hotele (Hotels)\",\n        \"Biura podróży (Travel agencies)\",\n        \"Kwiaciarnie (Florists)\",\n        \"Fotografowie (Photographers)\",\n        \"Agencje marketingowe (Marketing agencies)\",\n        \"Agencje pośrednictwa pracy (Job agencies)\",\n        \"Agencje ochrony (Security agencies)\",\n        \"Banki (Banks)\",\n        \"Drukarnie i poligrafia (Printing)\",\n        \"Grafika komputerowa (Computer graphics)\",\n        \"Serwis komputerów (Computer repair)\",\n        \"Informatycy (IT specialists)\",\n        \"Parkingi (Parking)\",\n        \"Przeprowadzki (Moving services)\"\n      ],\n      \"default\": \"hydraulicy\",\n      \"prefill\": \"hydraulicy\"\n    },\n    \"searchTerms\": {\n      \"title\": \"Search terms / keywords\",\n      \"type\": \"array\",\n      \"description\": \"What to look for, in Polish: a trade or any keyword, e.g. `hydraulik`, `restauracja`, `montaż klimatyzacji`. Every term is searched in every location. When set, `category` is ignored.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"locations\": {\n      \"title\": \"Locations\",\n      \"type\": \"array\",\n      \"description\": \"Polish cities, counties or voivodeships, e.g. `Warszawa`, `Kraków`, `pomorskie`. Each term is combined with every location. Leave empty to use `city`, or to search all of Poland.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"city\": {\n      \"title\": \"City\",\n      \"type\": \"string\",\n      \"description\": \"Restrict results to a curated city when `locations` is empty. Choose \\\"Whole Poland\\\" for a nationwide search.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"warszawa\",\n        \"krakow\",\n        \"lodz\",\n        \"wroclaw\",\n        \"poznan\",\n        \"gdansk\",\n        \"szczecin\",\n        \"bydgoszcz\",\n        \"lublin\",\n        \"katowice\",\n        \"bialystok\",\n        \"gdynia\",\n        \"czestochowa\",\n        \"radom\",\n        \"rzeszow\",\n        \"torun\",\n        \"kielce\",\n        \"gliwice\",\n        \"zabrze\",\n        \"olsztyn\",\n        \"sosnowiec\",\n        \"bielsko_biala\",\n        \"bytom\",\n        \"zielona_gora\",\n        \"rybnik\",\n        \"ruda_slaska\",\n        \"tychy\",\n        \"opole\",\n        \"gorzow_wielkopolski\",\n        \"elblag\",\n        \"plock\",\n        \"walbrzych\",\n        \"wloclawek\",\n        \"tarnow\",\n        \"chorzow\",\n        \"koszalin\",\n        \"kalisz\",\n        \"legnica\",\n        \"grudziadz\",\n        \"slupsk\",\n        \"jaworzno\",\n        \"jastrzebie_zdroj\",\n        \"nowy_sacz\",\n        \"jelenia_gora\",\n        \"siedlce\",\n        \"myslowice\"\n      ],\n      \"enumTitles\": [\n        \"Whole Poland\",\n        \"Warszawa\",\n        \"Kraków\",\n        \"Łódź\",\n        \"Wrocław\",\n        \"Poznań\",\n        \"Gdańsk\",\n        \"Szczecin\",\n        \"Bydgoszcz\",\n        \"Lublin\",\n        \"Katowice\",\n        \"Białystok\",\n        \"Gdynia\",\n        \"Częstochowa\",\n        \"Radom\",\n        \"Rzeszów\",\n        \"Toruń\",\n        \"Kielce\",\n        \"Gliwice\",\n        \"Zabrze\",\n        \"Olsztyn\",\n        \"Sosnowiec\",\n        \"Bielsko-Biała\",\n        \"Bytom\",\n        \"Zielona Góra\",\n        \"Rybnik\",\n        \"Ruda Śląska\",\n        \"Tychy\",\n        \"Opole\",\n        \"Gorzów Wielkopolski\",\n        \"Elbląg\",\n        \"Płock\",\n        \"Wałbrzych\",\n        \"Włocławek\",\n        \"Tarnów\",\n        \"Chorzów\",\n        \"Koszalin\",\n        \"Kalisz\",\n        \"Legnica\",\n        \"Grudziądz\",\n        \"Słupsk\",\n        \"Jaworzno\",\n        \"Jastrzębie-Zdrój\",\n        \"Nowy Sącz\",\n        \"Jelenia Góra\",\n        \"Siedlce\",\n        \"Mysłowice\"\n      ],\n      \"default\": \"warszawa\",\n      \"prefill\": \"warszawa\"\n    },\n    \"startUrls\": {\n      \"title\": \"PanoramaFirm URLs (mode=byUrl)\",\n      \"type\": \"array\",\n      \"description\": \"PanoramaFirm search-results URLs (including page URLs) or business profile URLs. Search URLs paginate automatically.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"sort\": {\n      \"title\": \"Sort order (mode=search)\",\n      \"type\": \"string\",\n      \"description\": \"How PanoramaFirm should order results before they're scraped. Only affects which businesses are emitted first when `maxItems` truncates the result set.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"popularity\",\n        \"rating\",\n        \"az\",\n        \"za\"\n      ],\n      \"enumTitles\": [\n        \"Most popular (site default)\",\n        \"Highest rated first\",\n        \"Alphabetical (A-Z)\",\n        \"Alphabetical (Z-A)\"\n      ],\n      \"default\": \"popularity\",\n      \"prefill\": \"popularity\"\n    },\n    \"openNowOnly\": {\n      \"title\": \"Open now only (mode=search)\",\n      \"type\": \"boolean\",\n      \"description\": \"Only keep businesses PanoramaFirm currently marks as open (based on their published opening hours).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"fetchDetails\": {\n      \"title\": \"Fetch full profile details\",\n      \"type\": \"boolean\",\n      \"description\": \"Visit each business's profile page to also collect opening hours, description, NIP, GPS coordinates, videos, galleries, and full review data. Slower but richer. Turn off for a fast, listing-only scrape.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"integer\",\n      \"description\": \"Only keep businesses with a rating at or above this value (1-5). Businesses with no rating yet are excluded when this is set.\",\n      \"minimum\": 1,\n      \"maximum\": 5\n    },\n    \"minReviewCount\": {\n      \"title\": \"Minimum review count\",\n      \"type\": \"integer\",\n      \"description\": \"Only keep businesses with at least this many customer reviews. 0 disables the filter.\",\n      \"minimum\": 0,\n      \"maximum\": 100000,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"requireWebsite\": {\n      \"title\": \"Only businesses with a website\",\n      \"type\": \"boolean\",\n      \"description\": \"Drop businesses that don't publish a website.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"requirePhone\": {\n      \"title\": \"Only businesses with a phone number\",\n      \"type\": \"boolean\",\n      \"description\": \"Drop businesses that don't publish a phone number.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"requireEmail\": {\n      \"title\": \"Only businesses with an email\",\n      \"type\": \"boolean\",\n      \"description\": \"Drop businesses that don't publish an email address.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on the number of business records emitted.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 50,\n      \"prefill\": 3\n    },\n    \"maxPages\": {\n      \"title\": \"Max results pages per search\",\n      \"type\": \"integer\",\n      \"description\": \"Safety cap on how many 25-result pages are read for each search term and location.\",\n      \"minimum\": 1,\n      \"maximum\": 200,\n      \"default\": 40,\n      \"prefill\": 40\n    },\n    \"maxConcurrency\": {\n      \"title\": \"Parallel profile requests\",\n      \"type\": \"integer\",\n      \"description\": \"How many business profiles to fetch at the same time. Lower it if you see rate limiting.\",\n      \"minimum\": 1,\n      \"maximum\": 20,\n      \"default\": 5,\n      \"prefill\": 5\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# PanoramaFirm.pl Polish Business Directory Finder\n\nPanoramaFirm.pl is one of Poland's largest business directories: trades and professions organized by city, county, and voivodeship, with phone numbers, websites, tax IDs, ratings, reviews, and profile galleries. This actor turns that directory into structured business rows for lead generation, local SEO, CRM enrichment, and market research.\n\nIt searches by category or free-text keyword, combines many terms with many Polish locations in one run, paginates automatically, and can either read the results pages only (fast) or open every business profile for the full record (rich).\n\n## What this actor does\n\n- Searches a curated category or any Polish keyword, in one location or across the whole country.\n- Cross-joins `searchTerms` with `locations`, so one run can collect, for example, `hydraulik` × `Warszawa`, `Kraków`, and `pomorskie`.\n- Accepts PanoramaFirm search URLs and business profile URLs directly, including result-page URLs.\n- Sorts by popularity, highest rating, or alphabetically, and filters to currently open businesses or a minimum rating.\n- Optionally visits every business profile to add NIP, opening hours, coordinates, full descriptions, review text, social links, and photo/video galleries.\n- Handles Polish diacritics (ą, ć, ę, ł, ń, ó, ś, ź, ż) in both search input and output.\n- Leaves a field out of a record whenever the business never published that value — no empty strings, nulls, or placeholder values.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` for the directory, `byUrl` for explicit PanoramaFirm URLs. |\n| `category` | string | `hydraulicy` | Curated trade to browse when `searchTerms` is empty. |\n| `searchTerms` | array | `[]` | Keywords or trades in Polish, e.g. `hydraulik`, `restauracja`, `montaż klimatyzacji`. |\n| `locations` | array | `[]` | Cities, counties, or voivodeships, e.g. `Warszawa`, `Kraków`, `pomorskie`. |\n| `city` | string | `warszawa` | Curated city used when `locations` is empty; choose \"Whole Poland\" for nationwide. |\n| `startUrls` | array | `[]` | PanoramaFirm search-results URLs or business profile URLs. |\n| `fetchDetails` | boolean | `true` | Open each profile for NIP, hours, coordinates, reviews, galleries, and descriptions. |\n| `sort` | string | `popularity` | `popularity`, `rating`, `az`, or `za`. |\n| `openNowOnly` | boolean | `false` | Keep only businesses currently marked open. |\n| `minRating` | integer | – | Keep only businesses rated at or above this value (1–5). |\n| `minReviewCount` | integer | `0` | Keep only businesses with at least this many reviews. |\n| `requireWebsite` | boolean | `false` | Drop businesses without a website. |\n| `requirePhone` | boolean | `false` | Drop businesses without a phone number. |\n| `requireEmail` | boolean | `false` | Drop businesses without an email address. |\n| `maxItems` | integer | `50` | Hard cap on emitted business records (1–1000). |\n| `maxPages` | integer | `40` | Safety cap on 25-result pages read per term/location. |\n| `maxConcurrency` | integer | `5` | Number of business profiles fetched in parallel. |\n\n### Example: one trade across several cities\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"hydraulik\"],\n  \"locations\": [\"Warszawa\", \"Kraków\", \"pomorskie\"],\n  \"fetchDetails\": true,\n  \"maxItems\": 150\n}\n```\n\n### Example: highly rated restaurants with a website\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restauracje\",\n  \"city\": \"krakow\",\n  \"sort\": \"rating\",\n  \"minRating\": 4,\n  \"minReviewCount\": 5,\n  \"requireWebsite\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: fetch specific profiles or a saved search URL\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    \"https://panoramafirm.pl/hydraulicy/,,warszawa/firmy,2.html\",\n    \"https://panoramafirm.pl/mazowieckie,płoński,popielżyn_dolny,14/hyd_bud_pawel_brzeszkiewicz-sbjbzz_fhm.html\"\n  ],\n  \"fetchDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n## Output per business\n\n| Field | Description |\n|---|---|\n| `name` | Business name |\n| `category`, `categorySlug`, `categories` | Industry label and PanoramaFirm category slug |\n| `address`, `street`, `city`, `postalCode`, `county`, `voivodeship`, `country` | Split postal address |\n| `phone`, `website`, `email` | Contact details when published |\n| `nip` | Polish tax identification number (profile lookups) |\n| `rating`, `reviewCount` | Average rating and number of reviews |\n| `reviews` | Up to ten recent reviews with author, rating, date, and text (profile lookups) |\n| `openingHours` | Weekly hours as `{day, opens, closes}` entries, when PanoramaFirm publishes structured hours |\n| `description`, `servicesDescription`, `serviceArea` | Business description, services, and service area (profile lookups) |\n| `latitude`, `longitude` | GPS coordinates (profile lookups) |\n| `facebookUrl`, `instagramUrl`, `linkedinUrl`, `youtubeUrl`, `tiktokUrl`, `twitterUrl`, `googleMapsUrl` | Social and map links when published |\n| `logoUrl`, `galleryImages`, `videoUrls`, `certificateImages` | Logo, gallery photos, YouTube videos, and certificate images |\n| `profileUrl`, `slug`, `companyId` | Canonical profile URL, PanoramaFirm slug, and internal company ID |\n| `searchTerm`, `searchLocation` | Which input term and location produced the row |\n| `recordType`, `scrapedAt` | Record marker and UTC scrape timestamp |\n\n## Use cases\n\n- **B2B lead generation** — build prospect lists by trade across many Polish cities in one run.\n- **Local SEO auditing** — compare a client's listing with competitors in the same category and location.\n- **CRM enrichment** — attach verified phone, email, address, NIP, and coordinates to existing records.\n- **Market density research** — count competitors by trade, city, county, or voivodeship.\n- **Directory aggregation** — normalize Polish business data into a wider listings product.\n\n## FAQ\n\n**Do I need an account, cookies, or an API key?**\nNo. PanoramaFirm.pl is a public directory; this actor needs no login, key, or browser.\n\n**Do I need to configure a proxy?**\nNo. The actor connects directly and only switches to Apify Proxy automatically if PanoramaFirm temporarily rejects a request.\n\n**Which categories and locations are supported?**\nThe dropdowns are shortcuts for common trades and cities, but `searchTerms` and `locations` accept any Polish keyword, city, county, or voivodeship that PanoramaFirm recognizes — including small towns and all 16 voivodeships.\n\n**Why do some businesses have fewer fields than others?**\nPanoramaFirm only publishes what each business filled in. A missing phone, email, website, NIP, or hours entry is left out of the record rather than emitted as a placeholder.\n\n**Can `openNowOnly` return zero results even when the category has businesses in that city?**\nYes. PanoramaFirm's \"open now\" listing is not scoped as tightly to the selected category and location as a normal search, so combining it with narrow filters can genuinely return nothing. Try widening the filters or turning `openNowOnly` off.\n\n**Are opening hours always available?**\nOnly when PanoramaFirm publishes structured hours for that profile. Many profiles show hours only in free-text descriptions, in which case the actor does not guess them.\n\n**Can I re-fetch a business I already have a URL for?**\nYes — use `mode: \"byUrl\"` with profile URLs, or paste a results-page URL to resume a search from any page.\n\n**How fresh is the data?**\nEach run reads PanoramaFirm's live pages, so results reflect what is currently published.\n\n**Is this affiliated with PanoramaFirm.pl?**\nNo. This actor reads PanoramaFirm.pl's public pages and is not affiliated with, endorsed by, or connected to PanoramaFirm.pl.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "panoramafirm-pl-polish-business-directory-finder",
      "title": "PanoramaFirm.pl Polish Business Directory Finder",
      "description": "Search PanoramaFirm.pl by category or keyword across Polish cities, counties, and regions, fetch search-result pages, or enrich specific business profile URLs with address, phone, website, email, NIP, opening hours, rating, reviews, social links, coordinates, and galleries.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# PanoramaFirm.pl Polish Business Directory Finder\n\nPanoramaFirm.pl is one of Poland's largest business directories: trades and professions organized by city, county, and voivodeship, with phone numbers, websites, tax IDs, ratings, reviews, and profile galleries. This actor turns that directory into structured business rows for lead generation, local SEO, CRM enrichment, and market research.\n\nIt searches by category or free-text keyword, combines many terms with many Polish locations in one run, paginates automatically, and can either read the results pages only (fast) or open every business profile for the full record (rich).\n\n## What this actor does\n\n- Searches a curated category or any Polish keyword, in one location or across the whole country.\n- Cross-joins `searchTerms` with `locations`, so one run can collect, for example, `hydraulik` × `Warszawa`, `Kraków`, and `pomorskie`.\n- Accepts PanoramaFirm search URLs and business profile URLs directly, including result-page URLs.\n- Sorts by popularity, highest rating, or alphabetically, and filters to currently open businesses or a minimum rating.\n- Optionally visits every business profile to add NIP, opening hours, coordinates, full descriptions, review text, social links, and photo/video galleries.\n- Handles Polish diacritics (ą, ć, ę, ł, ń, ó, ś, ź, ż) in both search input and output.\n- Leaves a field out of a record whenever the business never published that value — no empty strings, nulls, or placeholder values.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search` for the directory, `byUrl` for explicit PanoramaFirm URLs. |\n| `category` | string | `hydraulicy` | Curated trade to browse when `searchTerms` is empty. |\n| `searchTerms` | array | `[]` | Keywords or trades in Polish, e.g. `hydraulik`, `restauracja`, `montaż klimatyzacji`. |\n| `locations` | array | `[]` | Cities, counties, or voivodeships, e.g. `Warszawa`, `Kraków`, `pomorskie`. |\n| `city` | string | `warszawa` | Curated city used when `locations` is empty; choose \"Whole Poland\" for nationwide. |\n| `startUrls` | array | `[]` | PanoramaFirm search-results URLs or business profile URLs. |\n| `fetchDetails` | boolean | `true` | Open each profile for NIP, hours, coordinates, reviews, galleries, and descriptions. |\n| `sort` | string | `popularity` | `popularity`, `rating`, `az`, or `za`. |\n| `openNowOnly` | boolean | `false` | Keep only businesses currently marked open. |\n| `minRating` | integer | – | Keep only businesses rated at or above this value (1–5). |\n| `minReviewCount` | integer | `0` | Keep only businesses with at least this many reviews. |\n| `requireWebsite` | boolean | `false` | Drop businesses without a website. |\n| `requirePhone` | boolean | `false` | Drop businesses without a phone number. |\n| `requireEmail` | boolean | `false` | Drop businesses without an email address. |\n| `maxItems` | integer | `50` | Hard cap on emitted business records (1–1000). |\n| `maxPages` | integer | `40` | Safety cap on 25-result pages read per term/location. |\n| `maxConcurrency` | integer | `5` | Number of business profiles fetched in parallel. |\n\n### Example: one trade across several cities\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchTerms\": [\"hydraulik\"],\n  \"locations\": [\"Warszawa\", \"Kraków\", \"pomorskie\"],\n  \"fetchDetails\": true,\n  \"maxItems\": 150\n}\n```\n\n### Example: highly rated restaurants with a website\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restauracje\",\n  \"city\": \"krakow\",\n  \"sort\": \"rating\",\n  \"minRating\": 4,\n  \"minReviewCount\": 5,\n  \"requireWebsite\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: fetch specific profiles or a saved search URL\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    \"https://panoramafirm.pl/hydraulicy/,,warszawa/firmy,2.html\",\n    \"https://panoramafirm.pl/mazowieckie,płoński,popielżyn_dolny,14/hyd_bud_pawel_brzeszkiewicz-sbjbzz_fhm.html\"\n  ],\n  \"fetchDetails\": true,\n  \"maxItems\": 50\n}\n```\n\n## Output per business\n\n| Field | Description |\n|---|---|\n| `name` | Business name |\n| `category`, `categorySlug`, `categories` | Industry label and PanoramaFirm category slug |\n| `address`, `street`, `city`, `postalCode`, `county`, `voivodeship`, `country` | Split postal address |\n| `phone`, `website`, `email` | Contact details when published |\n| `nip` | Polish tax identification number (profile lookups) |\n| `rating`, `reviewCount` | Average rating and number of reviews |\n| `reviews` | Up to ten recent reviews with author, rating, date, and text (profile lookups) |\n| `openingHours` | Weekly hours as `{day, opens, closes}` entries, when PanoramaFirm publishes structured hours |\n| `description`, `servicesDescription`, `serviceArea` | Business description, services, and service area (profile lookups) |\n| `latitude`, `longitude` | GPS coordinates (profile lookups) |\n| `facebookUrl`, `instagramUrl`, `linkedinUrl`, `youtubeUrl`, `tiktokUrl`, `twitterUrl`, `googleMapsUrl` | Social and map links when published |\n| `logoUrl`, `galleryImages`, `videoUrls`, `certificateImages` | Logo, gallery photos, YouTube videos, and certificate images |\n| `profileUrl`, `slug`, `companyId` | Canonical profile URL, PanoramaFirm slug, and internal company ID |\n| `searchTerm`, `searchLocation` | Which input term and location produced the row |\n| `recordType`, `scrapedAt` | Record marker and UTC scrape timestamp |\n\n## Use cases\n\n- **B2B lead generation** — build prospect lists by trade across many Polish cities in one run.\n- **Local SEO auditing** — compare a client's listing with competitors in the same category and location.\n- **CRM enrichment** — attach verified phone, email, address, NIP, and coordinates to existing records.\n- **Market density research** — count competitors by trade, city, county, or voivodeship.\n- **Directory aggregation** — normalize Polish business data into a wider listings product.\n\n## FAQ\n\n**Do I need an account, cookies, or an API key?**\nNo. PanoramaFirm.pl is a public directory; this actor needs no login, key, or browser.\n\n**Do I need to configure a proxy?**\nNo. The actor connects directly and only switches to Apify Proxy automatically if PanoramaFirm temporarily rejects a request.\n\n**Which categories and locations are supported?**\nThe dropdowns are shortcuts for common trades and cities, but `searchTerms` and `locations` accept any Polish keyword, city, county, or voivodeship that PanoramaFirm recognizes — including small towns and all 16 voivodeships.\n\n**Why do some businesses have fewer fields than others?**\nPanoramaFirm only publishes what each business filled in. A missing phone, email, website, NIP, or hours entry is left out of the record rather than emitted as a placeholder.\n\n**Can `openNowOnly` return zero results even when the category has businesses in that city?**\nYes. PanoramaFirm's \"open now\" listing is not scoped as tightly to the selected category and location as a normal search, so combining it with narrow filters can genuinely return nothing. Try widening the filters or turning `openNowOnly` off.\n\n**Are opening hours always available?**\nOnly when PanoramaFirm publishes structured hours for that profile. Many profiles show hours only in free-text descriptions, in which case the actor does not guess them.\n\n**Can I re-fetch a business I already have a URL for?**\nYes — use `mode: \"byUrl\"` with profile URLs, or paste a results-page URL to resume a search from any page.\n\n**How fresh is the data?**\nEach run reads PanoramaFirm's live pages, so results reflect what is currently published.\n\n**Is this affiliated with PanoramaFirm.pl?**\nNo. This actor reads PanoramaFirm.pl's public pages and is not affiliated with, endorsed by, or connected to PanoramaFirm.pl.\n",
      "input": {
        "title": "PanoramaFirm Business Directory Scraper Input",
        "description": "Search PanoramaFirm.pl by category or keyword and Polish location, or fetch search-results and business profile URLs directly.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "Search the directory, or fetch specific PanoramaFirm URLs.",
            "editor": "select",
            "enum": [
              "search",
              "byUrl"
            ],
            "enumTitles": [
              "Search by category or keyword",
              "Fetch specific PanoramaFirm URLs"
            ],
            "default": "search",
            "prefill": "search"
          },
          "category": {
            "title": "Business category (branża)",
            "type": "string",
            "description": "Category to browse when `searchTerms` is empty. Pick one of the curated Polish trades.",
            "editor": "select",
            "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"
            ],
            "enumTitles": [
              "Adwokaci (Lawyers)",
              "Doradztwo prawne (Legal consulting)",
              "Doradztwo podatkowe (Tax consulting)",
              "Biura rachunkowe (Accounting offices)",
              "Księgowi (Accountants)",
              "Hydraulicy (Plumbers)",
              "Elektrycy (Electricians)",
              "Mechanika samochodowa (Car mechanics)",
              "Pomoc drogowa (Roadside assistance)",
              "Myjnie samochodowe (Car washes)",
              "Dealerzy i sprzedaż samochodów (Car dealers)",
              "Brukarstwo (Paving)",
              "Dachy i rynny (Roofing & gutters)",
              "Architektura krajobrazu (Landscape architecture)",
              "Biura architektoniczne (Architecture offices)",
              "Budowa i wykończenia pod klucz (Turnkey construction)",
              "Chemia budowlana (Construction chemicals)",
              "Armatura hydrauliczna (Plumbing fixtures)",
              "Geodezja (Surveying)",
              "Fryzjerzy i salony fryzjerskie (Hairdressers)",
              "Salony kosmetyczne (Beauty salons)",
              "Stomatolodzy (Dentists)",
              "Dermatolodzy (Dermatologists)",
              "Dietetycy (Dietitians)",
              "Weterynarze (Veterinarians)",
              "Apteki (Pharmacies)",
              "Alergolodzy (Allergists)",
              "Chirurdzy (Surgeons)",
              "Chirurgia plastyczna (Plastic surgery)",
              "Ginekolodzy i położnicy (Gynecologists)",
              "Kardiolodzy (Cardiologists)",
              "Laryngolodzy (ENT doctors)",
              "Lekarze rodzinni (Family doctors)",
              "Logopedzi (Speech therapists)",
              "Restauracje (Restaurants)",
              "Catering",
              "Hotele (Hotels)",
              "Biura podróży (Travel agencies)",
              "Kwiaciarnie (Florists)",
              "Fotografowie (Photographers)",
              "Agencje marketingowe (Marketing agencies)",
              "Agencje pośrednictwa pracy (Job agencies)",
              "Agencje ochrony (Security agencies)",
              "Banki (Banks)",
              "Drukarnie i poligrafia (Printing)",
              "Grafika komputerowa (Computer graphics)",
              "Serwis komputerów (Computer repair)",
              "Informatycy (IT specialists)",
              "Parkingi (Parking)",
              "Przeprowadzki (Moving services)"
            ],
            "default": "hydraulicy",
            "prefill": "hydraulicy"
          },
          "searchTerms": {
            "title": "Search terms / keywords",
            "type": "array",
            "description": "What to look for, in Polish: a trade or any keyword, e.g. `hydraulik`, `restauracja`, `montaż klimatyzacji`. Every term is searched in every location. When set, `category` is ignored.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Polish cities, counties or voivodeships, e.g. `Warszawa`, `Kraków`, `pomorskie`. Each term is combined with every location. Leave empty to use `city`, or to search all of Poland.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Restrict results to a curated city when `locations` is empty. Choose \"Whole Poland\" for a nationwide search.",
            "editor": "select",
            "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"
            ],
            "enumTitles": [
              "Whole Poland",
              "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"
            ],
            "default": "warszawa",
            "prefill": "warszawa"
          },
          "startUrls": {
            "title": "PanoramaFirm URLs (mode=byUrl)",
            "type": "array",
            "description": "PanoramaFirm search-results URLs (including page URLs) or business profile URLs. Search URLs paginate automatically.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "sort": {
            "title": "Sort order (mode=search)",
            "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.",
            "editor": "select",
            "enum": [
              "popularity",
              "rating",
              "az",
              "za"
            ],
            "enumTitles": [
              "Most popular (site default)",
              "Highest rated first",
              "Alphabetical (A-Z)",
              "Alphabetical (Z-A)"
            ],
            "default": "popularity",
            "prefill": "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,
            "prefill": false
          },
          "fetchDetails": {
            "title": "Fetch full profile details",
            "type": "boolean",
            "description": "Visit each business's profile page to also collect opening hours, description, NIP, GPS coordinates, videos, galleries, and full review data. Slower but richer. Turn off for a fast, listing-only scrape.",
            "default": true,
            "prefill": true
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "integer",
            "description": "Only keep businesses with a rating at or above this value (1-5). Businesses with no rating yet are excluded when this is set.",
            "minimum": 1,
            "maximum": 5
          },
          "minReviewCount": {
            "title": "Minimum review count",
            "type": "integer",
            "description": "Only keep businesses with at least this many customer reviews. 0 disables the filter.",
            "minimum": 0,
            "maximum": 100000,
            "default": 0,
            "prefill": 0
          },
          "requireWebsite": {
            "title": "Only businesses with a website",
            "type": "boolean",
            "description": "Drop businesses that don't publish a website.",
            "default": false,
            "prefill": false
          },
          "requirePhone": {
            "title": "Only businesses with a phone number",
            "type": "boolean",
            "description": "Drop businesses that don't publish a phone number.",
            "default": false,
            "prefill": false
          },
          "requireEmail": {
            "title": "Only businesses with an email",
            "type": "boolean",
            "description": "Drop businesses that don't publish an email address.",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on the number of business records emitted.",
            "minimum": 1,
            "maximum": 1000,
            "default": 50,
            "prefill": 3
          },
          "maxPages": {
            "title": "Max results pages per search",
            "type": "integer",
            "description": "Safety cap on how many 25-result pages are read for each search term and location.",
            "minimum": 1,
            "maximum": 200,
            "default": 40,
            "prefill": 40
          },
          "maxConcurrency": {
            "title": "Parallel profile requests",
            "type": "integer",
            "description": "How many business profiles to fetch at the same time. Lower it if you see rate limiting.",
            "minimum": 1,
            "maximum": 20,
            "default": 5,
            "prefill": 5
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "PanoramaFirm.pl Polish Business Directory Finder Output",
        "description": "PanoramaFirm.pl business records with full contact, address, category, rating, opening hours, tax ID, coordinates, social links, reviews, and gallery data.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "PanoramaFirm businesses",
            "description": "Dataset containing all scraped PanoramaFirm.pl businesses.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "category",
                  "categories",
                  "city",
                  "street",
                  "address",
                  "phone",
                  "email",
                  "website",
                  "nip",
                  "rating",
                  "reviewCount",
                  "openingHours",
                  "latitude",
                  "longitude",
                  "searchTerm",
                  "searchLocation",
                  "profileUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "00bdbcf41e43c805220a3f9013f0673a31f3f1ffa0e2f62ddad70e406cc4808b",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.010094444444444444
    }
  }
}