Firmy.cz Business Directory Scraper: 3 Practical Use Cases

Direct answer

Firmy.cz Business Directory Scraper extracts profile information from the Seznam.cz network without requiring an account. You can query free-text keywords, browse hierarchical categories restricted by Czech kraje, or fetch exact detail profiles using specific URLs. Depending on whether detail enrichment is active, collected attributes include names, addresses, coordinates, phones, emails, company registration numbers (IČO), working hours, and review ratings. Practical success depends on selecting an exact business objective, scoping the geographic parameters correctly, and validating the returned dataset before piping records into external business operations.

Core review criteria for Czech directory records

Automating data extraction from Firmy.cz creates value only when the collected records satisfy verified structural checks. Evaluating raw listings against clear guidelines prevents dirty records from degrading sales or analytical systems.

First, isolate administrative identity attributes from marketing contact data. The Czech identification number (icoId) acts as a primary business identifier, whereas phone numbers or generic inquiry emails can fluctuate. When scraping without deep detail mode, remember that company IDs and direct email addresses are excluded from basic overview cards. Match your configuration to your minimum required schema before running large jobs.

Second, treat geographic matching cautiously. The city input performs text-matching across address components. In certain Czech locations, district names refer to nearby urban hubs (for instance, Plzeňské Předměstí within the town of Rokycany). If strict administrative jurisdiction matters, rely on mode: byCategory with a set region and district parameter rather than simple keyword filtering.

Finally, distinguish between public directory endpoints and private company websites. The sourceUrl points back to Seznam's directory and resolves consistently. In contrast, target corporate homepages listed in the website field frequently deploy basic firewall rules that block simple automated HEAD pings. Validate external links with standard GET requests during downstream quality checks.

Practical use cases

These use cases come from Firmy.cz Business Directory Scraper's published documentation. Each is expanded into an operating pattern so the Firmy.cz Business Directory Scraper output has a purpose beyond collection.

Use case 1: Lead generation

Outcome: build prospect lists of local businesses by trade and region.

Question to answer: Of the records collected, which ones meet every hard requirement, and which are close but missing something?

Configure: Start with category (A Firmy.cz category path. Type any category path you find while browsing the site (e.g. Remesla-a-sluzby/Astrologicke-sluzby), or copy one of the 41 curated examples below into the field. Curated examples: Remesla-a-sluzby/Remesla/Instalaterstvi-a-topenarstvi/Instalaterstvi (Instalatérství a topenářství), Remesla-a-sluzby/Remesla/Servisy-a-opravarstvi (Servisy a opravárenství), Remesla-a-sluzby/Stavebni-sluzby (Stavební služby), Remesla-a-sluzby/Reality (Reality), Remesla-a-sluzby/Pravni-sluzby (Právní služby), Remesla-a-sluzby/Sluzby-pece-o-telo (Péče o tělo), Remesla-a-sluzby/Pocitacove-a-internetove-sluzby (Počítačové a internetové služby), Remesla-a-sluzby/Uklidove-a-cistici-sluzby (Úklidové a čisticí služby), Remesla-a-sluzby/Bezpecnostni-sluzby (Bezpečnostní služby), Remesla-a-sluzby/Fotograficke-sluzby (Fotografické služby), Remesla-a-sluzby/Vyukove-sluzby (Výukové služby), Remesla-a-sluzby/Krejcovske-a-strihove-sluzby (Krejčovské a střihové služby), Remesla-a-sluzby/Jazykove-sluzby (Jazykové služby), Remesla-a-sluzby/Pujcovny (Půjčovny), Restauracni-a-pohostinske-sluzby/Restaurace (Restaurace), Restauracni-a-pohostinske-sluzby/Hospody-a-hostince (Hospody a hostince), Restauracni-a-pohostinske-sluzby/Kavarny (Kavárny), Restauracni-a-pohostinske-sluzby/Rychla-obcerstveni (Rychlé občerstvení), Restauracni-a-pohostinske-sluzby/Cukrarny (Cukrárny), Restauracni-a-pohostinske-sluzby/Bary (Bary), Restauracni-a-pohostinske-sluzby/Vinarny (Vinárny), Restauracni-a-pohostinske-sluzby/Hotelove-restaurace (Hotelové restaurace), Auto-moto/Auto-moto-sluzby (Auto-moto služby), Auto-moto/Auto-moto-prodejci (Auto-moto prodejci), Banky-a-financni-sluzby/Ucetni-sluzby (Účetní služby), Banky-a-financni-sluzby/Pojistovaci-sluzby (Pojišťovací služby), Banky-a-financni-sluzby/Bankovni-a-sporitelni-sluzby (Bankovní a spořitelní služby), Cestovni-sluzby/Cestovni-kancelare-a-agentury (Cestovní kanceláře a agentury), Cestovni-sluzby/Ubytovaci-sluzby (Ubytovací služby), Dum-byt-a-zahrada/Sluzby-pro-dum-byt-a-zahradu (Služby pro dům, byt a zahradu), Dum-byt-a-zahrada/Prodejci-vybaveni-domu (Prodejci vybavení domu), Obchody-a-obchudky/Prodejci-potravin (Prodejci potravin), Obchody-a-obchudky/Prodejci-textilu-odevu-a-obuvi (Textil, oděvy a obuv), Obchody-a-obchudky/Prodejci-drogerie (Drogerie), Obchody-a-obchudky/Prodejci-nabytku (Nábytek), Obchody-a-obchudky/Knihy-a-tiskoviny (Knihy a tiskoviny), Obchody-a-obchudky/Prodejci-klenotu-a-hodinek (Klenoty a hodinky), Prvni-pomoc-a-zdravotnictvi/Zdravotnicke-sluzby (Zdravotnické služby), Prvni-pomoc-a-zdravotnictvi/Prodejci-zdravotnickeho-zbozi-a-leciv (Zdravotnické zboží a léčiva), Elektro-mobily-a-pocitace/Prodejci-vypocetni-techniky (Výpočetní technika), Vse-pro-firmy/Sluzby-pro-firmy/Administrativni-sluzby (Administrativní služby pro firmy), Vse-pro-firmy/Sluzby-pro-firmy/Reklamni-a-marketingove-sluzby (Reklamní a marketingové služby)), region (Restrict the category browse to one of the 14 Czech regions (kraje). Leave empty for nationwide.), searchQuery (Free-text keyword, e.g. business name, trade, or service ("instalater", "restaurace Praha", "kadeřnictví").). Use the narrowest Firmy.cz Business Directory Scraper values that represent the real task, keep the first result set small, and record why each selected input matters to the Firmy.cz Business Directory Scraper outcome.

Working method: Write the qualification rule down before looking at a single record, then sort candidates into qualified, needs research, and excluded with the reason recorded next to each one. Treat the result as research input, not permission to contact anyone.

Deliverable: Create a scored candidate list split into qualified, needs-research, and excluded groups, each with its supporting field and source link. Include the Firmy.cz Business Directory Scraper source identifier and the collected fields behind every Firmy.cz Business Directory Scraper decision.

Stop condition: Pause when identity is ambiguous, the fit reason cannot be traced to a collected field, or the workflow lacks a lawful and appropriate next step. Fix the Firmy.cz Business Directory Scraper question, comparison rule, or configuration before expanding the Firmy.cz Business Directory Scraper run.

Use case 2: Market research

Outcome: analyze business density, ratings, and coverage by city or category.

Question to answer: Once records are grouped fairly, which comparisons actually hold up and which were an artifact of the grouping?

Configure: Start with category (A Firmy.cz category path. Type any category path you find while browsing the site (e.g. Remesla-a-sluzby/Astrologicke-sluzby), or copy one of the 41 curated examples below into the field. Curated examples: Remesla-a-sluzby/Remesla/Instalaterstvi-a-topenarstvi/Instalaterstvi (Instalatérství a topenářství), Remesla-a-sluzby/Remesla/Servisy-a-opravarstvi (Servisy a opravárenství), Remesla-a-sluzby/Stavebni-sluzby (Stavební služby), Remesla-a-sluzby/Reality (Reality), Remesla-a-sluzby/Pravni-sluzby (Právní služby), Remesla-a-sluzby/Sluzby-pece-o-telo (Péče o tělo), Remesla-a-sluzby/Pocitacove-a-internetove-sluzby (Počítačové a internetové služby), Remesla-a-sluzby/Uklidove-a-cistici-sluzby (Úklidové a čisticí služby), Remesla-a-sluzby/Bezpecnostni-sluzby (Bezpečnostní služby), Remesla-a-sluzby/Fotograficke-sluzby (Fotografické služby), Remesla-a-sluzby/Vyukove-sluzby (Výukové služby), Remesla-a-sluzby/Krejcovske-a-strihove-sluzby (Krejčovské a střihové služby), Remesla-a-sluzby/Jazykove-sluzby (Jazykové služby), Remesla-a-sluzby/Pujcovny (Půjčovny), Restauracni-a-pohostinske-sluzby/Restaurace (Restaurace), Restauracni-a-pohostinske-sluzby/Hospody-a-hostince (Hospody a hostince), Restauracni-a-pohostinske-sluzby/Kavarny (Kavárny), Restauracni-a-pohostinske-sluzby/Rychla-obcerstveni (Rychlé občerstvení), Restauracni-a-pohostinske-sluzby/Cukrarny (Cukrárny), Restauracni-a-pohostinske-sluzby/Bary (Bary), Restauracni-a-pohostinske-sluzby/Vinarny (Vinárny), Restauracni-a-pohostinske-sluzby/Hotelove-restaurace (Hotelové restaurace), Auto-moto/Auto-moto-sluzby (Auto-moto služby), Auto-moto/Auto-moto-prodejci (Auto-moto prodejci), Banky-a-financni-sluzby/Ucetni-sluzby (Účetní služby), Banky-a-financni-sluzby/Pojistovaci-sluzby (Pojišťovací služby), Banky-a-financni-sluzby/Bankovni-a-sporitelni-sluzby (Bankovní a spořitelní služby), Cestovni-sluzby/Cestovni-kancelare-a-agentury (Cestovní kanceláře a agentury), Cestovni-sluzby/Ubytovaci-sluzby (Ubytovací služby), Dum-byt-a-zahrada/Sluzby-pro-dum-byt-a-zahradu (Služby pro dům, byt a zahradu), Dum-byt-a-zahrada/Prodejci-vybaveni-domu (Prodejci vybavení domu), Obchody-a-obchudky/Prodejci-potravin (Prodejci potravin), Obchody-a-obchudky/Prodejci-textilu-odevu-a-obuvi (Textil, oděvy a obuv), Obchody-a-obchudky/Prodejci-drogerie (Drogerie), Obchody-a-obchudky/Prodejci-nabytku (Nábytek), Obchody-a-obchudky/Knihy-a-tiskoviny (Knihy a tiskoviny), Obchody-a-obchudky/Prodejci-klenotu-a-hodinek (Klenoty a hodinky), Prvni-pomoc-a-zdravotnictvi/Zdravotnicke-sluzby (Zdravotnické služby), Prvni-pomoc-a-zdravotnictvi/Prodejci-zdravotnickeho-zbozi-a-leciv (Zdravotnické zboží a léčiva), Elektro-mobily-a-pocitace/Prodejci-vypocetni-techniky (Výpočetní technika), Vse-pro-firmy/Sluzby-pro-firmy/Administrativni-sluzby (Administrativní služby pro firmy), Vse-pro-firmy/Sluzby-pro-firmy/Reklamni-a-marketingove-sluzby (Reklamní a marketingové služby)), searchQuery (Free-text keyword, e.g. business name, trade, or service ("instalater", "restaurace Praha", "kadeřnictví").), city (Only keep results whose address/city/district contains this text (case- and diacritics-insensitive), e.g. Praha, Brno, Plzeň, České Budějovice. Works with any mode.). Use the narrowest Firmy.cz Business Directory Scraper values that represent the real task, keep the first result set small, and record why each selected input matters to the Firmy.cz Business Directory Scraper outcome.

Working method: Decide the comparison axis first, then place every record into a cohort before looking at outcomes. Keep raw and normalized values side by side, and review the records that do not fit any cohort instead of dropping them.

Deliverable: Create a side-by-side comparison table with cohort labels, normalized fields, and a short note on what the gap implies. Include the Firmy.cz Business Directory Scraper source identifier and the collected fields behind every Firmy.cz Business Directory Scraper decision.

Stop condition: Pause when the cohorts are structurally different, coverage is uneven, or the ranking depends mainly on missing values. Fix the Firmy.cz Business Directory Scraper question, comparison rule, or configuration before expanding the Firmy.cz Business Directory Scraper run.

Use case 3: Directory aggregation

Outcome: mirror or cross-reference Czech business listings.

Question to answer: Within the defined area and asset type, which entries actually belong in the same comparison set?

Configure: Start with searchQuery (Free-text keyword, e.g. business name, trade, or service ("instalater", "restaurace Praha", "kadeřnictví").), category (A Firmy.cz category path. Type any category path you find while browsing the site (e.g. Remesla-a-sluzby/Astrologicke-sluzby), or copy one of the 41 curated examples below into the field. Curated examples: Remesla-a-sluzby/Remesla/Instalaterstvi-a-topenarstvi/Instalaterstvi (Instalatérství a topenářství), Remesla-a-sluzby/Remesla/Servisy-a-opravarstvi (Servisy a opravárenství), Remesla-a-sluzby/Stavebni-sluzby (Stavební služby), Remesla-a-sluzby/Reality (Reality), Remesla-a-sluzby/Pravni-sluzby (Právní služby), Remesla-a-sluzby/Sluzby-pece-o-telo (Péče o tělo), Remesla-a-sluzby/Pocitacove-a-internetove-sluzby (Počítačové a internetové služby), Remesla-a-sluzby/Uklidove-a-cistici-sluzby (Úklidové a čisticí služby), Remesla-a-sluzby/Bezpecnostni-sluzby (Bezpečnostní služby), Remesla-a-sluzby/Fotograficke-sluzby (Fotografické služby), Remesla-a-sluzby/Vyukove-sluzby (Výukové služby), Remesla-a-sluzby/Krejcovske-a-strihove-sluzby (Krejčovské a střihové služby), Remesla-a-sluzby/Jazykove-sluzby (Jazykové služby), Remesla-a-sluzby/Pujcovny (Půjčovny), Restauracni-a-pohostinske-sluzby/Restaurace (Restaurace), Restauracni-a-pohostinske-sluzby/Hospody-a-hostince (Hospody a hostince), Restauracni-a-pohostinske-sluzby/Kavarny (Kavárny), Restauracni-a-pohostinske-sluzby/Rychla-obcerstveni (Rychlé občerstvení), Restauracni-a-pohostinske-sluzby/Cukrarny (Cukrárny), Restauracni-a-pohostinske-sluzby/Bary (Bary), Restauracni-a-pohostinske-sluzby/Vinarny (Vinárny), Restauracni-a-pohostinske-sluzby/Hotelove-restaurace (Hotelové restaurace), Auto-moto/Auto-moto-sluzby (Auto-moto služby), Auto-moto/Auto-moto-prodejci (Auto-moto prodejci), Banky-a-financni-sluzby/Ucetni-sluzby (Účetní služby), Banky-a-financni-sluzby/Pojistovaci-sluzby (Pojišťovací služby), Banky-a-financni-sluzby/Bankovni-a-sporitelni-sluzby (Bankovní a spořitelní služby), Cestovni-sluzby/Cestovni-kancelare-a-agentury (Cestovní kanceláře a agentury), Cestovni-sluzby/Ubytovaci-sluzby (Ubytovací služby), Dum-byt-a-zahrada/Sluzby-pro-dum-byt-a-zahradu (Služby pro dům, byt a zahradu), Dum-byt-a-zahrada/Prodejci-vybaveni-domu (Prodejci vybavení domu), Obchody-a-obchudky/Prodejci-potravin (Prodejci potravin), Obchody-a-obchudky/Prodejci-textilu-odevu-a-obuvi (Textil, oděvy a obuv), Obchody-a-obchudky/Prodejci-drogerie (Drogerie), Obchody-a-obchudky/Prodejci-nabytku (Nábytek), Obchody-a-obchudky/Knihy-a-tiskoviny (Knihy a tiskoviny), Obchody-a-obchudky/Prodejci-klenotu-a-hodinek (Klenoty a hodinky), Prvni-pomoc-a-zdravotnictvi/Zdravotnicke-sluzby (Zdravotnické služby), Prvni-pomoc-a-zdravotnictvi/Prodejci-zdravotnickeho-zbozi-a-leciv (Zdravotnické zboží a léčiva), Elektro-mobily-a-pocitace/Prodejci-vypocetni-techniky (Výpočetní technika), Vse-pro-firmy/Sluzby-pro-firmy/Administrativni-sluzby (Administrativní služby pro firmy), Vse-pro-firmy/Sluzby-pro-firmy/Reklamni-a-marketingove-sluzby (Reklamní a marketingové služby)), region (Restrict the category browse to one of the 14 Czech regions (kraje). Leave empty for nationwide.). Use the narrowest Firmy.cz Business Directory Scraper values that represent the real task, keep the first result set small, and record why each selected input matters to the Firmy.cz Business Directory Scraper outcome.

Working method: Fix the geography, asset type, and acceptable range before collecting anything, then group results into comparable sets and set aside anything that falls outside every set rather than forcing it into the nearest one.

Deliverable: Create a grouped review table with comparable sets, flagged outliers, and the fields still needed before a decision. Include the Firmy.cz Business Directory Scraper source identifier and the collected fields behind every Firmy.cz Business Directory Scraper decision.

Stop condition: Pause when location boundaries drift, key property attributes are missing, or non-comparable assets are being ranked together. Fix the Firmy.cz Business Directory Scraper question, comparison rule, or configuration before expanding the Firmy.cz Business Directory Scraper run.

Step-by-step setup workflow

1. Select your discovery strategy: Opt for search when investigating broad trades across the entire country, byCategory combined with specific region settings for territorial mapping, or byUrl for targeted profile refreshes.
2. Determine enrichment depth: Toggle fetchDetails to true if your pipeline requires per-day business hours, email addresses, and official IČO codes. Leave it disabled to conduct lightweight landscape scans.
3. Execute an initial test: Run a controlled batch bounded by maxItems: 10 to confirm that returned attributes conform to your downstream schema and database requirements.
4. Screen and sanitize values: Ensure UTF-8 diacritics are preserved across street addresses, inspect missing values, and verify that external corporate homepages resolve through full HTTP GET requests.
5. Automate target runs: Schedule recurring updates or batch executions using validated input configurations once quality audits confirm clean field mapping.

Input parameters reference

The Actor accepts specific configuration properties to control query execution:

• mode: Defines the operational mode. Accepts search, byCategory, or byUrl.
• searchQuery: Keyword query string applied when executing broad searches (such as trade terms or company names).
• category: A Firmy.cz category path, selectable from curated paths or custom site URLs.
• region: Restricts category queries to one of the 14 Czech kraje (for instance, praha, jihomoravsky, or plzensky).
• district: An optional local territory slug nested within the specified region (such as praha-1 or brno-mesto).
• urls: An array of direct detail-page links used for precision profile extraction.
• city: Case-insensitive text filter evaluated against address, city, and district strings.
• keyword: Best-effort text filter matching company names, summaries, or categories.
• minRating: Minimum review rating threshold on a 0 to 5 scale.
• openNowOnly: Boolean toggle restricting outputs to businesses open at the time of scraping.
• fetchDetails: Boolean switch instructing the crawler to fetch internal detail pages for email, IČO, and day-by-day opening hours.
• maxItems: Upper limit on total emitted dataset records.
• proxyConfiguration: Connection settings; automatically defaults to datacenter proxies if rate-limiting occurs.

Managing output data and edge cases

Firmy.cz omits empty attributes rather than publishing blank fields. If a company fails to display an email address or operating schedule, those keys will be omitted from the output JSON. Design your ingestion schemas to handle missing optional properties gracefully.

Ratings are converted by the Actor from Seznam's internal 0 to 100 percentage metric into a standard 0 to 5 numeric value. When benchmarking competitor satisfaction, weigh both rating and reviewCount to prevent single-review profiles from distorting analytical cohorts.

When verifying company websites, note that small business servers frequently reject automated network checks. Ensure external connection checks execute complete GET requests rather than basic HEAD queries before marking an enterprise website as offline.

Frequently asked questions

Do I need a Seznam.cz user profile to scrape data?

No. Public directory results, category hierarchies, and profile pages on Firmy.cz are accessible without an account, session tokens, or API keys.

How does the city filter behave during execution?

The city setting acts as an unanchored text comparison across address, municipality, and district attributes. Because some postal districts use names associated with larger municipalities, using mode: byCategory with a defined region and district is recommended for precise administrative scoping.

Why are email addresses and IČO numbers missing from basic runs?

Basic overview searches omit deep company identifiers to minimize network overhead. Set fetchDetails: true or execute mode: byUrl to collect the business detail pages containing registration numbers, email inboxes, and day-by-day schedules.

What does the IČO number represent?

The IČO (Identifikační číslo osoby) serves as the official legal registration number for companies and trade entities operating in the Czech Republic. It is ideal for deduplicating enterprise records against government records.

Resources

• Explore the tool on the platform: Firmy.cz Business Directory Scraper