# Czech Business Directory Leads Scraper (`scrapebench/czech-business-directory-leads-scraper`) Actor

Czech businesses from the Firmy.cz directory with phone, email, website, address, map point, category and company ID (ICO). Filter by city or look up a name.

- **URL**: https://apify.com/scrapebench/czech-business-directory-leads-scraper.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.001 / business listing

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Czech Business Directory Leads Scraper (Phone, Email, ICO)

### Pain points

- Firmy.cz shows a company's e-mail and ICO only on its own page, so a list of a few hundred firms is a few hundred page visits.
- The site offers no download of a city's businesses, so a prospect list means paging through search results and copying them out.
- A company's phone is printed as a national number (732 708 831), which a dialer or CRM cannot import without the +420 prefix.

### What we solve

- Returns every listing for the cities you pick in one run, with phone, e-mail, website, street, city, postcode, map coordinates, main category and ICO as separate columns.
- Looks a company up by name and returns the same columns.
- Gives each phone in international format (+420...) next to the printed one, and each business once.

### Summary

Build a Czech business prospect list in one run. Pick one or more cities, or look up companies by name, and get each listing's name, phone (also as +420...), e-mail, website, street, city, postcode, map coordinates, main category, rating and company ID (ICO) with the legal form. The Firmy.cz directory lists about one million businesses. Data comes from a stored copy of the directory, so a run returns in seconds; look-ups by name read the directory live. Pay only per listing returned.

### Who it's for

- B2B sales teams and agencies prospecting Czech companies by city
- Suppliers and distributors building dealer lists in Prague, Brno or Ostrava
- Marketing and data teams enriching a CRM with Czech phone, e-mail and ICO data
- Researchers counting businesses by city

### How to use

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

**Get a list (export):** no names, just filters; returns the whole matching list.

```json
{
  "cities": [
    "Brno"
  ],
  "maxResults": 200
}
```

**Check specific firms (lookup):** put company names or licence numbers in `queries`; **Inputs** below says how each is matched.

```json
{
  "queries": [
    "Inka Servis"
  ],
  "maxResults": 5
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `name` | Business name as listed |
| `phone` | Phone number as the page prints it (+420 xxx xxx xxx) |
| `phone_e164` | The same number in international format (+420...) |
| `email` | E-mail address, when the listing shows one |
| `website` | The business's own website, when listed |
| `street` | Street and house number |
| `city` | Municipality (the district is in extras.city_part) |
| `postal_code` | Postcode |
| `lat` | Latitude |
| `lng` | Longitude |
| `category` | The listing's main category |
| `extras` | ico (company ID), legal_form, rating_percent, review_count, description, city_part and any further phones, e-mails or websites |
| `listing_id` | The listing's ID on the directory, stable per business |
| `source` | 'snapshot' (stored copy) or 'live' |
| `source_url` | The business's page on the directory |

Sample:

```json
{
  "name": "Inka Servis",
  "phone": "+420 732 708 831",
  "phone_e164": "+420732708831",
  "email": "info@inkaservis.cz",
  "website": "https://inkaservis.cz",
  "street": "Lounsk\u00fdch 753/12",
  "city": "Praha",
  "postal_code": "14000",
  "lat": 50.0603658333,
  "lng": 14.4335858333,
  "country": "CZ",
  "category": "Instalat\u00e9rstv\u00ed",
  "categories": [
    "Instalat\u00e9rstv\u00ed"
  ],
  "listing_id": "13556955",
  "source": "snapshot",
  "extras": {
    "ico": "76115585",
    "legal_form": "\u017eivnostensk\u00fd list",
    "city_part": "Nusle",
    "rating_percent": 70.7,
    "review_count": 12
  },
  "source_url": "https://www.firmy.cz/detail/13556955-inka-servis-praha-nusle.html"
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"auto"` | export: no names, just filters; returns the whole matching list. lookup: put business names in 'queries'. auto picks the mode for you. |
| `query` | no | string | — | A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks. |
| `queries` | no | array | `[]` | A business name (or listing number) to look up live. Several values in one run; combined with 'query'. |
| `city` | no | string | — | Only listings in this city. Kept alongside 'cities' for saved tasks. |
| `cities` | no | array | `[]` | Only listings in this city. Several values in one run; combined with 'city'. |
| `categories` | no | array | `[]` | Only rows from this directory part (one or more). Available: part-09, part-10, part-11, part-12, part-13, part-14, part-15, part-16, part-17, part-18, part-19, part-20, part-21, part-22, part-23, part-24, part-25, part-26, part-27, part-28, part-29, part-30, part-31, part-32, part-33, part-41, part-42, part-43, part-44, part-45, part-46. These are slices of the directory's own listing index (about 30,000 businesses each), not trades: leave them empty and filter by `cities`, or look a business up by name. |
| `maxResults` | no | integer | `500` | Per query in lookup mode; per run in export mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Used only for live lookups; exports read the stored snapshot. |

### Pricing (Pay Per Event)

You pay per result (`dataset-item`) — **no charge for empty runs**. Example: **500 business listings** at *$0.001/result* ≈ **$0.50**.

Notices (unknown city, a request too large for one run, stale data) are free.

### Use cases

- Outbound lead generation: every listed business in Brno with phone and e-mail, ready for a CRM import.
- KYB and CRM enrichment: look a company up by name and get its ICO, legal form, address and contact.
- Territory planning: list the businesses of several towns with map coordinates and plot them.
- Market sizing: count listings per city before you buy a full list.

### Why this actor

- E-mail and ICO on the listing row, not behind a per-company page visit.
- Phone also in international +420 format, ready for a dialer.
- City filter with or without Czech letters ('Brno', 'Plzen' and 'Plzeň' all work).
- Each business once. Pay per listing; notices are free.

### Limitations & updates

Covers businesses listed on Firmy.cz. Export data is served from a stored copy, so it can be weeks old; the run log states its date. The export is chosen by city; trade search is by name look-up. A listing shows an e-mail or website only when its owner entered one. No contact person is returned.

### FAQ

**Where does the data come from?**

The public Firmy.cz business directory. We keep a stored copy of its listings and serve exports from it, so results come back in seconds. The run log states the date of the copy. A look-up by name reads the directory live.

**How do I choose cities?**

'cities' takes one value or a list, with or without Czech letters. The city is the municipality; the district (for example Nusle in Praha) is in extras.city_part.

**Can I search by trade, like plumbers?**

Each listing carries its main category, so you can filter the rows. The export is organised by city, not trade. To find a business, use a look-up by name.

**Does it include e-mail and the company ID?**

Yes, when the listing has them: e-mail in the email column, the 8-digit ICO and the legal form in extras.

**How current is it?**

The stored copy is refreshed when it is older than a month and the actor is in use. The run log states the date of the copy, and a run served from a copy older than 45 days returns one free notice saying so.

**How am I charged?**

One event per business listing returned. Notices are free.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run Czech Business Directory Leads Scraper (Phone, Email, ICO)](https://scrapebench.dev/guides/how-to-czech-business-directory-leads-scraper/)
- **Use case:** [Brno Business List with Phone, Email and ICO (Czechia)](https://scrapebench.dev/use-cases/brno-businesses/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/czech-business-directory-leads-scraper/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "List businesses in Brno, Czechia, with their phone numbers, e-mails and company IDs."

That is the city 'Brno' export; set maxResults to keep a first call small. Runs started this way bill exactly like any other run.

### Use it from an AI agent (Agent Skill)

The free [`scrapebench-b2b-leads`](https://github.com/scrapebenchhq/apify-actor-skills/tree/main/scrapebench-b2b-leads) skill teaches Claude Code and other agents to find the right scrapebench Actor for the task and run it. Copy the folder into `~/.claude/skills/`, set `APIFY_TOKEN`, and ask in plain words.

### Data & lawful use

This actor collects publicly available information that Firmy.cz (Seznam.cz, a.s.) publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
Firmy.cz (Seznam.cz, a.s.). Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `mode` (type: `string`):

export: no names, just filters; returns the whole matching list. lookup: put business names in 'queries'. auto picks the mode for you.

## `query` (type: `string`):

A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks.

## `queries` (type: `array`):

A business name (or listing number) to look up live. Several values in one run; combined with 'query'.

## `city` (type: `string`):

Only listings in this city. Kept alongside 'cities' for saved tasks.

## `cities` (type: `array`):

Only listings in this city. Several values in one run; combined with 'city'.

## `categories` (type: `array`):

Only rows from this directory part (one or more). Available: part-09, part-10, part-11, part-12, part-13, part-14, part-15, part-16, part-17, part-18, part-19, part-20, part-21, part-22, part-23, part-24, part-25, part-26, part-27, part-28, part-29, part-30, part-31, part-32, part-33, part-41, part-42, part-43, part-44, part-45, part-46. These are slices of the directory's own listing index (about 30,000 businesses each), not trades: leave them empty and filter by `cities`, or look a business up by name.

## `maxResults` (type: `integer`):

Per query in lookup mode; per run in export mode.

## `proxyConfiguration` (type: `object`):

Used only for live lookups; exports read the stored snapshot.

## Actor input object example

```json
{
  "mode": "auto",
  "queries": [],
  "cities": [],
  "categories": [],
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per business listing; notices are free.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/czech-business-directory-leads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/czech-business-directory-leads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call scrapebench/czech-business-directory-leads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/czech-business-directory-leads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/obgHgPvtCUznfO0Ny/builds/8HxC4blTBvxPYhwCh/openapi.json
