Firmy.cz Scraper

🏢 Firmy.cz Scraper

Turn Firmy.cz, Seznam's Czech company directory, into a clean lead list. Search by what a company does and where it is (or paste Firmy.cz search, category and company URLs) and get the name, every phone number with its label, emails, website, address, GPS, ICO, data box, rating, opening hours and categories for each company. No login and no browser: it reads the site's own data feed, so 1,000 companies with full profiles took about 35 seconds in our tests.

✨ Why use Firmy.cz Scraper?

• ⚡ Fast — reads the same data feed the Firmy.cz website uses, 100 companies per request, with profiles loaded in parallel.
• 📞 Complete contacts — every phone with its label (Sekretariát, Obchod, Dispečink...), every email and website, data box and social profiles.
• 🧾 Registry data on request — add ARES (the official Czech business register): founding date, legal form, VAT ID, registered address, NACE codes and whether the company is still active or in liquidation.
• 🎯 Precise targeting — many queries × many cities in one run, strict city matching, minimum rating and review filters, "only with phone / email / website".
• 🔁 No duplicates — a company found by several searches is saved once, with every query and location that found it.
• 💸 Pay per company — you pay only for companies saved; filtered-out companies are never charged.

🎯 Use cases

• 📈 B2B lead generation — every logistics company in Kladno, every accountant in Brno, with phones and emails for outreach.
• 🗺️ Local market mapping — count and map competitors in a city or region by category, with GPS coordinates.
• 🧹 CRM enrichment and cleanup — add ICO, VAT ID, founding date and "still active" from ARES to your company lists.
• ⭐ Reputation research — compare ratings and review counts of restaurants, garages or clinics across cities.
• 🛠️ Sales territory planning — export companies per district with opening hours and websites for field sales.

🚀 How to use

1. Enter one or more search queries (e.g. logistika, restaurace, instalatér) and locations (e.g. Kladno, Praha 5, okres Kladno, Jihomoravský kraj). Leave locations empty for the whole Czech Republic.
2. Or paste Firmy.cz URLs: a search page, a category page or company profiles.
3. Set Max results per search (0 = everything Firmy.cz lists for that search) and pick filters if you need them.
4. Click Start and download the results as JSON, CSV, Excel or HTML, or read them through the API.

📥 Input

{
  "searchQueries": ["logistika", "autodoprava"],
  "locations": ["Kladno", "Unhošť"],
  "maxResultsPerQuery": 20,
  "includeDetails": true,
  "strictLocationMatch": true,
  "enrichAres": true,
  "proxyConfiguration": { "useScrapelyProxy": true, "scrapelyProxyGroups": ["DATACENTER"] }
}

📤 Output

One row per company. The main fields:

Example (one company, trimmed):

{
  "search_query": "logistika",
  "location": "Kladno",
  "id": 2632820,
  "name": "VCHD Cargo a.s.",
  "phone_primary": "+420 312 245 107",
  "phones_all": "Telefon: +420 312 245 107",
  "phones": [{ "label": "Telefon", "number": "+420 312 245 107", "is_primary": true }],
  "email": "info@vchd.cz",
  "emails": ["info@vchd.cz"],
  "web_url": "https://vchd.cz",
  "address": "Železárenská 315, 272 01 Kladno",
  "locality": "Kladno",
  "postal_code": "27201",
  "district": "Kladno",
  "latitude": 50.1515450035,
  "longitude": 14.1062330402,
  "categories": ["Doprava a přeprava", "Mezistátní nákladní silniční dopravci", "Logistické služby"],
  "ico": "27231551",
  "dic": "CZ27231551",
  "data_box": "msugy4m",
  "rating_value": 4.5,
  "rating_count": 2,
  "opening_hours": [{ "day": "monday", "hours": "08:00-16:00" }, { "day": "saturday", "hours": "closed" }],
  "social_networks": [{ "network": "facebook", "url": "https://www.facebook.com/vchd.cz/" }],
  "profile_url": "https://www.firmy.cz/detail/2632820-vchd-cargo-a-s-kladno.html",
  "established_at": "2005-04-28",
  "ares": {
    "matched": true,
    "business_name": "VCHD Cargo a.s.",
    "legal_form_name": "Akciová společnost",
    "is_active": true,
    "in_liquidation": false,
    "vat_id": "CZ27231551"
  },
  "matched_search_queries": ["logistika"],
  "matched_locations": ["Kladno"],
  "location_match": { "is_match": true, "matched_target": "Kladno", "actual_locality": "Kladno", "mode": "municipality" }
}

💰 Pricing

You pay $0.40 per 1,000 companies saved ($0.0004 per company), plus the small platform usage of the run (compute and proxy traffic), which is billed separately. Full profiles and ARES data are included in that price.

Example: 1,000 companies with full profiles ≈ $0.40 for the results plus about $0.015 of platform usage (our 1,000-company test run took 34 seconds and 13 MB of datacenter proxy traffic: about $0.0014 of compute at the default 512 MB and $0.013 of proxy), so about $0.42 in total.

❓ FAQ

Is it legal to scrape Firmy.cz? The actor reads only public company listings that anyone can see without an account. You are responsible for how you use the data, in particular for personal data of sole traders under GDPR and for direct-marketing rules.

Do I need a login or my own proxy? No. No account, cookies or API key are needed, and the built-in datacenter proxy is enough.

How many companies can I get? As many as Firmy.cz lists for your search: set maxResultsPerQuery to 0 to take everything. Broad searches such as restaurace return over 16,000 companies nationwide. For a whole category split by city, add several locations.

Why is a field empty? The company did not fill it in on Firmy.cz (many small businesses list no email or website). Turn on onlyWithEmail / onlyWithPhone / onlyWithWebsite to skip them; skipped companies are not charged. With includeDetails off, emails, extra phones, data box and opening hours are not loaded.

Why do I get companies from neighbouring towns? Firmy.cz ranks nearby companies into a city search. Turn on strictLocationMatch to keep only companies whose address is in the city or district you asked for.

Can I schedule it or use the API? Yes. Schedule runs to keep your lists fresh, and start runs and download results through the API in JSON, CSV or Excel.

⚠️ Limits

• Only data Firmy.cz shows publicly; it does not visit company websites to look for more emails.
• Reviews' texts are not included, only the rating, review count and verdict.
• Strict location matching works on cities and districts; for regions the site's own region search is used as is.
• ARES data is available only for companies that list an ICO on Firmy.cz.