Firmy.cz Business Directory Scraper

Scrape Firmy.cz, the leading Czech business directory (part of the Seznam.cz network). Search any keyword, browse by category and region, or fetch specific business detail pages — no login, no cookies, no API key required.

What this actor does

• Three modes: search (free-text, nationwide), byCategory (browse a curated category + one of the 14 Czech regions + optional district), byUrl (fetch specific business detail pages)
• Rich business data: name, categories, full address (street/city/district/postal code), GPS coordinates, phone, rating and review count, opening status, and more
• Optional deep enrichment: turn on fetchDetails to additionally pull email, IČO (Czech company ID), a second phone number, and full per-day opening hours from each business's detail page
• Filters: city/location text filter, minimum rating, "open now" only, free-text keyword filter
• Empty fields are omitted — every record only contains data actually found for that business
• Full Czech UTF-8 diacritics support — city names, addresses, and descriptions are preserved exactly (Plzeň, České Budějovice, Žižkov, etc.)

Output per business

• businessId, sourceUrl — unique ID and canonical Firmy.cz detail-page URL
• name
• categories[] — trade/service tags (e.g. Instalatérství, Restaurace)
• street, postalCode, city, district, fullAddress
• latitude, longitude
• phone, phoneSecondary (detail only), email (detail only), website
• icoId — Czech company registration number (IČO), when the business has one (detail only)
• rating (0-5), reviewCount
• openNow (boolean), openingHoursSummary (text snippet), openingHours[] — per-day breakdown {day, dayEn, date, hours} (detail only)
• description
• photoUrl
• galleryImages[] — additional photo URLs from the business's detail-page gallery, when published (detail only)
• recordType: "business", scrapedAt

(detail only) fields are only populated when fetchDetails: true is set (search/byCategory modes) or when using mode: byUrl.

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / byUrl
searchQuery	string	instalater	Free-text keyword (mode=search)
category	string	Restauracni-a-pohostinske-sluzby/Restaurace	Any Firmy.cz category path (mode=byCategory); 41 curated examples listed in the field description
region	string (enum)	–	One of 14 Czech regions/kraje (mode=byCategory)
district	string	–	District/city slug within the region, e.g. praha-1, brno-mesto (mode=byCategory, requires region)
urls	array	–	Firmy.cz detail-page URLs (mode=byUrl)
city	string	–	Keep only results whose address/city/district contains this text (diacritics-insensitive)
keyword	string	–	Keep only results whose name/description/categories contain this text
minRating	number	–	Drop businesses rated below this (0-5)
openNowOnly	boolean	false	Only businesses currently marked open
fetchDetails	boolean	false	Visit each business's detail page for email/IČO/full hours (1 extra request per business)
maxItems	integer	30	Hard cap (1-500)
proxyConfiguration	object	–	Optional; firmy.cz works without a proxy, the actor auto-escalates to the free AUTO group on 403/429

Example: search with city + rating filter

{
  "mode": "search",
  "searchQuery": "restaurace",
  "city": "Brno",
  "minRating": 4,
  "maxItems": 50
}

Example: browse a category by region, with full detail enrichment

{
  "mode": "byCategory",
  "category": "Restauracni-a-pohostinske-sluzby/Restaurace",
  "region": "jihomoravsky",
  "fetchDetails": true,
  "maxItems": 100
}

Example: fetch specific business pages

{
  "mode": "byUrl",
  "urls": [
    "https://www.firmy.cz/detail/12918549-a-k-servis-praha-stare-mesto.html"
  ]
}

Use cases

• Lead generation — build prospect lists of local businesses by trade and region
• Market research — analyze business density, ratings, and coverage by city or category
• Directory aggregation — mirror or cross-reference Czech business listings
• Local SEO audits — check a business's own directory data (address, hours, phone) for accuracy
• Competitive analysis — compare ratings and review counts across competitors in a category

FAQ

Do I need a Seznam.cz login? No. Firmy.cz's search, category browsing, and business detail pages are all publicly accessible without an account.

Does the city filter guarantee I only get businesses in that city? It's a best-effort text filter over the address, city, and district fields. For reliable location scoping, use mode: byCategory with region (and optionally district) — this uses Firmy.cz's own region-scoped URL structure rather than text matching. Note that district names occasionally reference a nearby larger city (e.g. "Plzeňské Předměstí" in Rokycany), so a city filter can rarely surface a match outside the city itself.

Why does a website URL sometimes fail a plain curl -I check? The website field links to each business's own external site, not to Firmy.cz. Some small-business sites block simple bot HEAD requests (common shared-hosting/WAF behavior) while working fine in any real browser or a full GET request. sourceUrl (the Firmy.cz detail page) and photoUrl (Firmy.cz's own CDN) are always directly verifiable.

What's IČO? The Czech company identification number (Identifikační číslo osoby), roughly equivalent to a US EIN or UK company number. Only returned when fetchDetails is on and the business has one on file.

Why is rating on a 0-5 scale when Firmy.cz shows a percentage internally? Firmy.cz's structured data reports ratings on a 0-100 scale; the actor converts this to the more familiar 0-5 scale (rating = internalScore / 20).

Can I browse categories not in the dropdown? Yes — type any Firmy.cz category path into the category field (e.g. found while browsing the site, like Remesla-a-sluzby/Astrologicke-sluzby). The dropdown lists the ~40 most common categories for convenience.

How fresh is the data? Firmy.cz listings are maintained by business owners and Seznam.cz's own data team; most information (hours, ratings) is close to real-time.

Is this actor affiliated with Firmy.cz or Seznam.cz? No. This is an independent, third-party actor that reads Firmy.cz's publicly available pages. It is not affiliated with, endorsed by, or sponsored by Seznam.cz.