# Firmy.cz Scraper - Czech Business Directory & Leads (`haketa/firmy-cz-scraper`) Actor

Scrape Firmy.cz, the largest Czech business directory (Seznam.cz). Extract company name, phone, website, full address, GPS coordinates, category, rating and description from search results. Export JSON, CSV, Excel for B2B lead generation and local market research.

- **URL**: https://apify.com/haketa/firmy-cz-scraper.md
- **Developed by:** [Haketa](https://apify.com/haketa) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.75 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Firmy.cz Scraper — Czech Business Directory with Phone, Website & Ratings

> **The most complete Firmy.cz data extractor on Apify.** Pull business listings from **Firmy.cz — the largest business directory in the Czech Republic** (part of Seznam.cz) — with company name, **phone**, **website**, full address, GPS coordinates, category, rating and description. Built for B2B lead generation, local market research and sales intelligence.

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com/haketa/firmy-cz-scraper)
[![Live Data](https://img.shields.io/badge/Data-Live%20at%20Run%20Time-orange)]()
[![Pricing](https://img.shields.io/badge/Pricing-Pay%20Per%20Result-yellow)]()
[![Region](https://img.shields.io/badge/Region-Czech%20Republic%20%F0%9F%87%A8%F0%9F%87%BF-red)]()
[![Coverage](https://img.shields.io/badge/Coverage-Millions%20of%20Businesses-purple)]()
[![Phone](https://img.shields.io/badge/Includes-Phone%20%26%20Website-success)]()
[![Geo](https://img.shields.io/badge/Includes-GPS%20%26%20Ratings-brightgreen)]()
[![No Auth](https://img.shields.io/badge/Auth-None%20Required-success)]()
[![Export](https://img.shields.io/badge/Export-JSON%20%C2%B7%20CSV%20%C2%B7%20Excel-lightgrey)]()

***

### 🎯 What this actor does

The **Firmy.cz Scraper** extracts business listings from **firmy.cz** — the Czech Republic's dominant business directory, operated by Seznam.cz and covering restaurants, shops, services, tradespeople, professionals and companies of every kind across the country. Paste a Firmy.cz search URL and it returns **every business across all result pages**, one clean row per company.

Firmy.cz is a goldmine for **B2B lead generation**: nearly every listing includes a **phone number and a website**, alongside the full address, GPS location and rating.

Each record can include:

- 📞 **Phone** — contact phone number (present on the vast majority of listings)
- 🌐 **Website** — the company's own website
- 🏢 **Name & category** — business name and type
- 📍 **Address** — street, city/district, postal code and country
- 🗺️ **GPS** — latitude and longitude
- ⭐ **Rating** — rating value and number of ratings
- 📝 **Description** — business description
- 🖼️ **Image** — listing photo
- 🔗 **URL** — direct link to the Firmy.cz detail page
- 🕒 **Metadata** — the search keyword and `scrapedAt` timestamp on every row

Whether you run a sales team, a lead-gen agency or a local-market research project, this actor is the **fastest path from Firmy.cz to a usable dataset** — no scraping code required.

***

### ✨ Why this actor

| ✅ This actor handles | ❌ What you'd fight doing it yourself |
|---|---|
| **Phone + website on most listings** | The two fields that matter most for outreach |
| **Full pagination** | Searches span many result pages |
| **Structured address + GPS** | Location is nested and needs parsing |
| **Ratings & descriptions** | Extra context for qualifying leads |
| **Clean deduplicated rows** | Listings repeat across pages and need de-duping |
| **JSON / CSV / Excel export** | Raw data needs reshaping for CRM import |

***

### 🚀 Quick start

#### One-click run

1. Open the actor on the [Apify Store](https://apify.com/haketa/firmy-cz-scraper) and click **Try for free**
2. On **firmy.cz**, search by keyword and location, then copy the URL — e.g. `https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755`
3. Paste it into **Search URLs**, set **Max businesses** (`0` for unlimited)
4. Hit **Start** — businesses stream into your dataset, ready to export as JSON, CSV, Excel, HTML or RSS

#### Run via API (Python)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "startUrls": ["https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755"],
    "maxItems": 500,
}

run = client.actor("haketa/firmy-cz-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], "|", item["telephone"], "|", item["website"])
```

#### Run via API (JavaScript)

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

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('haketa/firmy-cz-scraper').call({
    startUrls: ['https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755'],
    maxItems: 500,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

***

### ⚙️ Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `startUrls` | array | – | Firmy.cz search URLs. Every business across all result pages is collected. |
| `maxItems` | integer | `200` | Max businesses across all searches. `0` = unlimited. |
| `proxyConfiguration` | object | Apify Proxy | Proxy settings — recommended for reliable results at scale. |

#### 📋 How to build a search URL

1. Go to **firmy.cz** and search by keyword (e.g. `restaurace`, `advokát`, `instalatér`) and location
2. Copy the address-bar URL — it includes the query and map coordinates
3. Paste it into **Search URLs**. Add as many searches as you like.

***

### 📤 Output

One clean record per business:

```json
{
  "businessId": "331269",
  "name": "McDonald's",
  "telephone": "+420 724104314",
  "website": "https://restaurace.mcdonalds.cz/praha-chlumecka",
  "category": "LocalBusiness",
  "streetAddress": "Chlumecká 764/2",
  "locality": "Praha, Černý Most",
  "postalCode": "19800",
  "country": "CZ",
  "latitude": "50.1096000",
  "longitude": "14.5832624",
  "ratingValue": "82",
  "ratingCount": "113",
  "bestRating": "100",
  "description": "Provoz rychlého občerstvení se specializací na hamburgery...",
  "image": "https://d48-a.sdn.cz/d_48/c_img_E_F/9AsDph.jpeg",
  "url": "https://www.firmy.cz/detail/331269-mcdonald-s-praha-cerny-most.html",
  "searchQuery": "restaurace",
  "scrapedAt": "2026-08-11T10:34:20.659Z"
}
```

#### 📋 Fields

| Field | Description |
|-------|-------------|
| `businessId` · `name` | Firmy.cz ID and business name |
| `telephone` | 📞 Contact phone |
| `website` | 🌐 Company website |
| `category` | Business type |
| `streetAddress` · `locality` · `postalCode` · `country` | 📍 Full address |
| `latitude` · `longitude` | 🗺️ GPS coordinates |
| `ratingValue` · `ratingCount` · `bestRating` | ⭐ Rating (0–100 scale) and count |
| `description` · `image` | Business description and photo |
| `url` · `searchQuery` · `scrapedAt` | Detail URL, search keyword and timestamp |

Export everything to **JSON, CSV, Excel, HTML or RSS**, or pull it through the Apify API and integrations.

***

### 💡 Use cases

| Use case | How this actor helps |
|----------|----------------------|
| 📞 **B2B lead generation** | Collect Czech businesses with phone and website by category and city for outreach. |
| 🗺️ **Local market research** | Map competitors and services by location, with ratings and GPS. |
| 🏢 **Sales intelligence** | Build targeted prospect lists (e.g. all plumbers in Brno, all restaurants in Prague). |
| 📊 **Directory & data products** | Enrich your own product with structured Czech business inventory. |
| ⭐ **Reputation benchmarking** | Compare ratings across businesses in a category or area. |
| 🤖 **CRM enrichment** | Feed clean name/phone/website/address records straight into your CRM. |

***

### ❓ FAQ

**Do listings include phone and website?**
Yes — the large majority of Firmy.cz listings include both a phone number and a website, and this actor captures both.

**How many businesses can I collect?**
All of them in a search. Set `maxItems` to `0` for unlimited — Firmy.cz covers millions of Czech businesses.

**How do I target a specific city or category?**
Build the search on firmy.cz (keyword + location) and paste the resulting URL. Add multiple URLs for multiple searches.

**Do I need a proxy?**
Apify Proxy is enabled by default and recommended for reliable results at scale.

**Which export formats are supported?**
JSON, CSV, Excel, HTML and RSS, plus programmatic access via the Apify API and integrations (Google Sheets, Zapier, Make, Airbyte and more).

***

### 🔗 Integrations

Send results wherever you work: **Google Sheets / Excel**, **Zapier · Make · n8n**, **Airbyte / databases / webhooks**, and the **Apify API** for any language.

***

### ⚖️ Legal & responsible use

This actor collects **publicly available** business listing information — the same content any visitor can see on Firmy.cz search pages without logging in. It does not access private data and does not require any user account.

You are responsible for how you use the data. Please:

- Use the output for lawful purposes such as B2B lead generation, market research and sales intelligence.
- Respect the source platform's Terms of Service and robots directives.
- Comply with applicable data-protection and anti-spam laws (e.g. GDPR, ePrivacy) when contacting businesses.
- Do not republish scraped content in a way that infringes copyright or database rights.

*This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Firmy.cz or Seznam.cz. All product names, logos and brands are property of their respective owners.*

***

### 🛟 Support

Need an extra field or hit a search that won't parse? Open an issue from the actor's **Issues** tab and we'll take a look.

# Actor input Schema

## `startUrls` (type: `array`):

Paste Firmy.cz search URLs. Search on firmy.cz (keyword + location) and copy the URL — e.g. https://www.firmy.cz/?q=restaurace\&x=14.4378\&y=50.0755. The scraper collects every business across all result pages.

## `maxItems` (type: `integer`):

Maximum number of businesses to collect across all search URLs. Set to 0 for unlimited.

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

Proxy configuration. Apify Proxy is enabled by default and recommended for reliable results at scale.

## Actor input object example

```json
{
  "startUrls": [
    "https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755"
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `businessId` (type: `string`):

Firmy.cz premise/detail ID

## `name` (type: `string`):

Business name

## `telephone` (type: `string`):

Contact phone

## `website` (type: `string`):

Business website (from sameAs)

## `category` (type: `string`):

Schema.org business type

## `streetAddress` (type: `string`):

Street address

## `locality` (type: `string`):

City / district

## `postalCode` (type: `string`):

Postal code

## `country` (type: `string`):

Country code

## `latitude` (type: `string`):

GPS latitude

## `longitude` (type: `string`):

GPS longitude

## `ratingValue` (type: `string`):

Rating value (0-100 scale)

## `ratingCount` (type: `string`):

Number of ratings

## `bestRating` (type: `string`):

Rating scale maximum

## `description` (type: `string`):

Business description

## `image` (type: `string`):

Business image URL

## `url` (type: `string`):

Firmy.cz detail page URL

## `searchQuery` (type: `string`):

Search keyword used (from the URL)

## `scrapedAt` (type: `string`):

Extraction timestamp

# 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 = {
    "startUrls": [
        "https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755"
    ],
    "maxItems": 100,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("haketa/firmy-cz-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 = {
    "startUrls": ["https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755"],
    "maxItems": 100,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("haketa/firmy-cz-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 '{
  "startUrls": [
    "https://www.firmy.cz/?q=restaurace&x=14.4378&y=50.0755"
  ],
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call haketa/firmy-cz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,haketa/firmy-cz-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/SIcihYFux36WTRo1Q/builds/TRdXUeZGIGU6GFvkt/openapi.json