Firmy.cz Scraper

Pull Czech business listings from Firmy.cz at scale — names, addresses, phone numbers, websites, ratings, opening hours, geo coordinates, IČO, Datová schránka, and photo galleries for 750,000+ verified businesses across all 13 Seznam.cz top-level categories. Built for Czech B2B sales teams, EU market-entry consultants, and CRM data engineers who need clean, structured firmy.cz data without parsing HTML and chasing consent gates themselves.

Why This Scraper?

• All 13 firmy.cz top-level categories — Restaurants, Auto & Motoring, Electronics, Shops, Services & Trades, Home & Garden, Healthcare, Health & Beauty, Banks & Finance, Travel, Government, Business Services, and Wholesale & Manufacturing. Health & Beauty is included where the leading competitor only ships 12.
• IČO and Datová schránka extraction — every detail-enriched record carries the Czech business ID and the official electronic mailbox identifier required for B2B compliance, invoicing, and government correspondence.
• 33 fields per business — name, full address breakdown (street, city, postal code), latitude/longitude, phone, email, website, rating (0–5) on Seznam's own scale, review count, one-line opening summary, full weekly schedule, logo, gallery, social links, amenities, sponsored/verified tags, short description, optional reservation link, IČO, Datová schránka, and a stable premiseId for cross-run deduplication.
• 4 input modes — free-text keyword, keyword + Czech city, category browse, or paste any firmy.cz search URL directly. Mix and match in a single run.
• Diacritic-safe Czech UTF-8 — names like "Lékárna U Černého orla" and "Žižkov" pass through input, pagination, and output cleanly. Tested on č ž ř ě ů á í é ý.
• Verified at full scale — 1,362 rows from a single lekárna Olomouc query in 4.5 minutes, with the full last page kept rather than trimmed.
• Optional best-effort detail enrichment — toggle to attempt IČO, Datová schránka, business email, the complete 7-day opening-hours table, social media links, amenities, full description, and up to ~28 photos per business. When firmy.cz's consent gate refuses on a given run, the listing-tier data still ships and the run continues with a one-line notice.
• City-level geo scoping built in — Czech cities, districts (okres), and regions (kraj) are auto-resolved to the correct firmy.cz scope through Seznam's own region geocoder, so "Praha", "Brno-venkov", and "Jihomoravský kraj" all just work.
• Unlimited mode — set Max Results to 0 to pull every available listing for a query (internal safety cap of 50,000 prevents runaway pagination).

Use Cases

Czech Market Entry & Lead Generation

• Build a national prospect list of pharmacies, dental clinics, or auto-services with phone, email, and IČO ready for cold outreach
• Extract verified contact info for every restaurant in a target Czech city before launching a delivery or POS product
• Pull complete supplier directories by category for procurement teams expanding into Czechia

B2B Compliance & KYC

• Capture IČO and Datová schránka identifiers required for Czech invoicing, contract enforcement, and government filings
• Cross-reference business names against the Czech business register for due diligence
• Maintain up-to-date supplier records with verified addresses and contact channels

Local SEO & Reputation Monitoring

• Track how your business and competitors rank inside firmy.cz category and city listings
• Monitor review counts and rating trends across the Czech market over time
• Audit your own listing fields (logo, photos, hours, website) against the public profile

Market Research & Competitive Analysis

• Map business density by Czech district to spot underserved categories
• Compare opening hours, ratings, and amenities across regional competitor sets
• Identify category leaders by review volume in any Czech city or region

Data Enrichment

• Append phone, email, geo coordinates, and IČO to existing CRM records keyed by business name and city
• Hydrate Czech business directories with structured rating and category data
• Power Czech-language map products with Seznam-grade business metadata

Getting Started

Search by Keyword

Just a Czech keyword — searches all of Czech Republic:

{
    "searchQuery": "restaurace",
    "maxResults": 50
}

Keyword + City

Scope a search to a single Czech city. The city name is auto-resolved through Seznam's geocoder:

{
    "searchQuery": "zubař",
    "location": "Praha",
    "maxResults": 200
}

Browse by Category with Full Details

Pull every Health & Beauty business in Brno with IČO, email, and full opening hours:

{
    "searchQuery": "kosmetika",
    "location": "Brno",
    "category": "zdravi-krasa",
    "includeDetails": true,
    "maxResults": 500
}

Paste Firmy.cz URLs Directly

Replicate exact firmy.cz filters by pasting search-result URLs:

{
    "searchUrls": [
        "https://www.firmy.cz/?q=lekárna&x=17.250879&y=49.594540&rt=mesto",
        "https://www.firmy.cz/?q=autoservis&x=14.42076&y=50.087811&rt=mesto"
    ],
    "maxResults": 0
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchUrls	string[]	[]	Paste one or more firmy.cz search-result URLs. When provided, these override the guided fields below.
searchQuery	string	"restaurace"	Free-text Czech keyword (e.g. "zubař", "autoservis", "kavárna").
location	string	""	Czech city or area to scope the search (e.g. "Praha", "Brno", "Plzeň"). Leave blank for nationwide.
category	select	All Categories	One of 13 top-level firmy.cz categories — see list below.

Category Options

Value	Meaning
all	All Categories
restauracni-sluzby	Restaurants & Food
auto-moto	Auto & Motoring
elektro-mobily-pocitace	Electronics, Phones & Computers
obchody	Shops & Retail
sluzby-a-remesla	Services & Trades
dum-byt-zahrada	Home, Apartment & Garden
zdravotnictvi	First Aid & Healthcare
zdravi-krasa	Health & Beauty
banky-finance	Banks & Finance
cestovni-sluzby	Travel Services
instituce-urady	Institutions & Government
vse-pro-firmy	Business Services
velkoobchod-vyroba	Wholesale & Manufacturing

Output Detail & Limits

Parameter	Type	Default	Description
includeDetails	boolean	false	Visit each business's profile page to capture IČO, email, full opening week, social links, amenities, and full photo gallery. Slower but much richer.
maxResults	integer	200	Hard cap on rows. Set to 0 for unlimited (a 50,000 internal safety cap still applies). The actor stops requesting new pages once the cap is reached but keeps the full final page.

Output

Here's a representative business record with detail enrichment enabled:

{
    "premiseId": "13099473",
    "name": "Lékárna U Černého orla",
    "categories": ["Lékárny", "Zdraví a krása"],
    "description": "Lékárna v centru Olomouce",
    "businessDescription": "Tradiční lékárna v centru Olomouce nabízí široký sortiment léků a zdravotnických potřeb.",
    "address": "Horní náměstí 17, 779 00 Olomouc",
    "streetAddress": "Horní náměstí 17",
    "locality": "Olomouc",
    "postalCode": "779 00",
    "latitude": 49.5938,
    "longitude": 17.2509,
    "telephone": "+420 585 224 111",
    "email": "info@lekarna-olomouc.cz",
    "webUrl": "https://www.lekarna-olomouc.cz",
    "socialLinks": ["https://www.facebook.com/lekarnaolomouc"],
    "ratingValue": 4.6,
    "ratingCount": 87,
    "reviewCount": 23,
    "ratingText": "Výborné",
    "openingInfo": "Otevřeno · zavírá v 18:00",
    "openingHours": {
        "monday": "08:00-18:00",
        "tuesday": "08:00-18:00",
        "wednesday": "08:00-18:00",
        "thursday": "08:00-18:00",
        "friday": "08:00-18:00",
        "saturday": "09:00-13:00"
    },
    "logoUrl": "https://d48-a.sdn.cz/d_48/c_img_QM_T/logo-lekarna.jpg",
    "photoUrl": "https://d48-a.sdn.cz/d_48/c_img_QO_R/main.jpg",
    "photos": ["https://d48-a.sdn.cz/d_48/p1.jpg", "https://d48-a.sdn.cz/d_48/p2.jpg"],
    "ico": "26789012",
    "dataBoxId": "x9y8z7w",
    "amenities": ["Bezbariérový přístup", "Platba kartou", "Parkování"],
    "tags": ["verified"],
    "priceRange": null,
    "bookingUrl": null,
    "detailPageUrl": "https://www.firmy.cz/detail/13099473-lekarna-u-cerneho-orla-olomouc.html",
    "searchUrl": "https://www.firmy.cz/?q=lek%C3%A1rna&x=17.2509&y=49.5938&rt=mesto",
    "scrapedAt": "2026-05-04T11:42:18Z"
}

Closed days are simply absent from the openingHours object — Sunday is omitted when the business is closed that day.

Identity & Categories

Field	Type	Description
premiseId	string	Stable firmy.cz business identifier — safe for deduplication across runs
name	string	Business name (Czech UTF-8)
categories	string[]	Czech category labels assigned by Seznam
description	string	Short tagline from the search result card (always available when published)
businessDescription	string	Full Czech description from the detail page (detail mode only)
detailPageUrl	string	Direct firmy.cz profile URL

Address & Location

Field	Type	Description
address	string	Full formatted address
streetAddress	string	Street and house number
locality	string	City or town
postalCode	string	Czech PSČ (postal code)
latitude	number	Latitude in decimal degrees
longitude	number	Longitude in decimal degrees

Contact & Booking

Field	Type	Description
telephone	string	Phone number in international format
email	string	Business email (detail mode only)
webUrl	string	Business website URL
socialLinks	string[]	Facebook, Instagram, LinkedIn, YouTube links (detail mode only)
bookingUrl	string	"Reserve a table" link when published (restaurants and similar)

Rating & Reviews

Field	Type	Description
ratingValue	number	Star rating on a 0–5 scale
ratingCount	number	Total number of ratings
reviewCount	number	Number of written reviews
ratingText	string	Czech rating label (e.g. "Výborné", "Dobré")

Hours & Media

Field	Type	Description
openingInfo	string	One-line open/closed status (e.g. "Otevřeno · zavírá v 18:00")
openingHours	object	Full weekly schedule keyed by lowercase English day (monday–sunday) with values like "08:00-18:00". Closed days are omitted (detail mode only).
logoUrl	string	Business logo image URL
photoUrl	string	Primary photo URL from the listing card
photos	string[]	Full photo gallery (detail mode only)

Czech Identifiers & Tags

Field	Type	Description
ico	string	IČO — Czech business ID (detail mode only)
dataBoxId	string	Datová schránka identifier (detail mode only)
amenities	string[]	Czech amenity tags (parking, card payment, accessibility, etc., detail mode only)
tags	string[]	Listing flags such as verified or sponsored
priceRange	string	Price range label when published

Traceability

Field	Type	Description
searchUrl	string	The firmy.cz URL the row originated from
scrapedAt	string	ISO 8601 timestamp of extraction

Tips for Best Results

• Use Czech keywords — firmy.cz indexes Czech-language terms (lékárna, zubař, autoservis). English equivalents return far fewer matches.
• Pre-resolve the city in the location field — typing "Praha" auto-maps to Seznam's mesto scope; districts like "Brno-venkov" map to okres, and regions like "Jihomoravský kraj" map to kraj. Pasting a manual URL with &rt=mesto / &rt=okres / &rt=kraj lets you replicate firmy.cz's own filters exactly.
• Turn on detail enrichment for B2B work — IČO, Datová schránka, and email only appear in detail mode. Without them, rows lack the Czech identifiers needed for invoicing and KYC.
• Use maxResults: 0 for full-market sweeps — a single category-and-city query like Olomouc pharmacies returns over 1,300 rows. The 50,000 internal safety cap protects you from infinite pagination.
• Mix URLs and guided fields — paste two or three firmy.cz URLs alongside a keyword search to combine pre-built filters with broad sweeps in a single run.
• Start at 50 rows to verify the data shape, then scale to thousands. The actor stops paginating once your cap is reached but keeps the full last page intact.
• Reviews are intentionally summarized — firmy.cz gates full review text behind a Seznam.cz login, so this actor returns rating values and counts but does not scrape full review bodies.

Pricing

$4.00 per 1,000 results — undercuts the comparable directory-scraper market by roughly 20%. No compute charges — you only pay per result returned.

Results	Estimated Cost
100	$0.40
1,000	$4.00
10,000	$40.00
100,000	$400.00

A "result" is any business row in the output dataset. Platform fees (storage, bandwidth) are additional and depend on your Apify plan.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate Czech market research, B2B lead generation, and CRM enrichment using publicly listed business data. Users are responsible for complying with Czech and EU law (including GDPR), Seznam.cz's Terms of Service, and any applicable local regulations. Do not use extracted data for spam, harassment, or any unlawful purpose. When processing personal contact details, follow GDPR rules on lawful basis, transparency, and data subject rights.