Firmy.cz Business Directory Scraper

Extract Czech company leads from Firmy.cz public search and category listings.

Firmy.cz Business Directory Scraper helps sales, recruiting, agency, and local-market teams turn Firmy.cz result pages into structured datasets with business names, profile URLs, categories, addresses, phones, websites, ratings, reviews, opening hints, coordinates, and descriptions.

What does Firmy.cz Business Directory Scraper do?

This actor searches public Firmy.cz listings and saves one dataset row per business.

It supports keyword searches such as restaurace Praha, autoservis Brno, or účetní Ostrava.

It also supports direct Firmy.cz search or category URLs.

The actor follows pagination until it reaches your maxItems limit.

It reads server-rendered listing data, so no browser is needed for the default workflow.

Who is it for?

• 🧭 Local lead generation teams building Czech prospect lists.
• 📞 Sales ops teams enriching CRM accounts with phones and websites.
• 🏢 Agencies researching restaurants, clinics, trades, and local services.
• 👥 Recruiters mapping employers in specific Czech cities or categories.
• 📊 Market researchers tracking local business density and ratings.

Why use it?

Firmy.cz contains local business profiles that are useful for outreach and market mapping.

Manual copy-paste is slow and inconsistent.

This scraper produces normalized rows that can be exported to CSV, Excel, Google Sheets, BI tools, or CRMs.

What data can you extract?

Field	Description
name	Business name
profileUrl	Firmy.cz detail URL
businessId	Numeric Firmy.cz ID parsed from the profile URL
categories	Listing tags such as Restaurace or Autoservisy
address	Human-readable address
phone	Public phone number when listed
website	External website from the listing metadata
ratingValue	Rating converted to a 0-5 scale
reviewCount	Number of reviews
openingStatus	Open/closed text shown on the listing
latitude, longitude	Coordinates from embedded metadata
description	Business description/snippet

How much does it cost to scrape Firmy.cz business leads?

The actor uses pay-per-event pricing.

There is a $0.005 start fee for each run.

Each saved business listing is charged as an item event with tiered per-item pricing:

Plan tier	Price per saved listing
FREE	$0.000065997
BRONZE	$0.000057389
SILVER	$0.000044763
GOLD	$0.000034433
PLATINUM	$0.000022956
DIAMOND	$0.000016069

Example cost before platform plan discounts: 100 saved listings on BRONZE cost about $0.0107 total ($0.005 start + 100 × $0.000057389). 1,000 saved listings on BRONZE cost about $0.0624 total.

For best cost control, start with a small maxItems value and increase it after checking the first dataset.

How to use it

1. Open the actor on Apify.
2. Add one or more search queries, for example restaurace Praha.
3. Optionally add Firmy.cz category/search URLs.
4. Set maxItems.
5. Keep includeDetails disabled for the fastest default run.
6. Run the actor.
7. Download the dataset as CSV, JSON, Excel, or connect it to your workflow.

Input

searchQueries

Firmy.cz keyword searches.

Examples:

• restaurace Praha
• autoservis Brno
• zubní ordinace Ostrava
• účetní Plzeň

startUrls

Firmy.cz URLs for search or category pages.

Use this when you already have a specific category path.

maxItems

Maximum businesses to save across all inputs.

includeDetails

When enabled, the actor visits each profile page and extracts visible email addresses if present.

This adds extra requests, so use it only when emails are important.

Output example

{
  "name": "Amiata - La Cucina Toscana",
  "profileUrl": "https://www.firmy.cz/detail/13957569-amiata-la-cucina-toscana-praha-vinohrady.html",
  "businessId": "13957569",
  "sourceQuery": "restaurace Praha",
  "categories": ["Restaurace"],
  "address": "Londýnská 608/52, Praha, Vinohrady",
  "phone": "+420 222514141",
  "website": "https://www.amiata.cz/cs/",
  "ratingValue": 5,
  "reviewCount": 18,
  "latitude": 50.07521438598633,
  "longitude": 14.433701515197754
}

Tips for better results

• Use Czech keywords for best coverage.
• Combine service and city names.
• Use category URLs when you need a narrow vertical.
• Keep includeDetails off for broad lead collection.
• Increase maxItems gradually.

Integrations

Use this actor with:

• Google Sheets for lead review.
• HubSpot or Pipedrive for sales prospecting.
• Clay or Make for enrichment workflows.
• BI dashboards for local-market analysis.
• Webhooks for scheduled lead exports.

API usage

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('automation-lab/firmy-cz-business-directory-scraper').call({
  searchQueries: ['restaurace Praha'],
  maxItems: 50
});
console.log(run.defaultDatasetId);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_APIFY_TOKEN')
run = client.actor('automation-lab/firmy-cz-business-directory-scraper').call({
    'searchQueries': ['autoservis Brno'],
    'maxItems': 50,
})
print(run['defaultDatasetId'])

cURL

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~firmy-cz-business-directory-scraper/runs?token=YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"searchQueries":["restaurace Praha"],"maxItems":50}'

MCP usage

Use the Apify MCP server with Claude Desktop or Claude Code:

https://mcp.apify.com/?tools=automation-lab/firmy-cz-business-directory-scraper

Claude Code CLI setup:

$claude mcp add --transport http apify-firmy-cz https://mcp.apify.com/?tools=automation-lab/firmy-cz-business-directory-scraper

Claude Desktop JSON config:

{
  "mcpServers": {
    "apify-firmy-cz": {
      "url": "https://mcp.apify.com/?tools=automation-lab/firmy-cz-business-directory-scraper"
    }
  }
}

Example prompts:

• "Scrape 100 restaurant leads from Firmy.cz in Prague."
• "Find autoservis businesses in Brno and export names, phones, and websites."
• "Create a Czech local lead list from this Firmy.cz category URL."

Scheduling

Schedule the actor weekly or monthly to refresh local lead lists.

Use small scheduled batches for city/category monitoring.

For CRM syncs, trigger downstream automations from the dataset-ready webhook.

Data quality notes

Firmy.cz profiles vary by business.

Some listings have phone numbers and websites.

Some listings only provide address and description.

Ratings are converted from Firmy.cz percent values to a 0-5 scale for convenience.

FAQ

Is this a Firmy.cz scraper for Czech company leads?

Yes. It is designed for public Firmy.cz search and category listings.

Does it require a Firmy.cz account?

No. The default workflow uses public pages only.

Troubleshooting

Why did I get fewer results than maxItems?

The query or category may have fewer public listings, or Firmy.cz may stop pagination earlier than expected.

Try a broader query or a different city/category.

Why are emails missing?

Firmy.cz listing pages do not always expose emails.

Enable includeDetails to scan profile pages, but many businesses still publish only phone and website.

Why is the website URL different from the button URL?

Tracking parameters are stripped where possible so users get cleaner website links.

Legality and responsible use

This actor extracts publicly available Firmy.cz business listing data.

Use the data in accordance with applicable laws, privacy rules, Firmy.cz terms, and outreach regulations.

For EU outreach, make sure your processing has a lawful basis and respect opt-out requests.

Related Automation Lab scrapers

• Google Maps Lead Finder
• ARES Czech Registry Scraper
• Das Telefonbuch Business Scraper
• GoYellow Scraper

Limitations

The actor focuses on public search and category listings.

It does not log in.

It does not bypass private contact forms.

It does not guarantee email extraction.

Changelog

0.1

Initial private development build with HTTP extraction, pagination, listing metadata, optional detail-page email scan, and Firmy.cz-focused input schema.

Support

If a query stops working, save the input and run ID.

Include the Firmy.cz URL or keyword, expected result count, and sample missing business when reporting an issue.