# Firmy.cz Czech Business Directory Scraper

> Firmy.cz Czech Business Directory Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured company listings from the Czech Firmy.cz business directory by keyword and optional city filter, returning deduplicated business profiles with optional business register enrichment.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/firmy?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/firmy-cz-czech-business-directory-scraper-f0c562d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lz7l4YItTcUaHNyVFQAGX

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability firmy-cz-czech-business-directory-scraper-f0c562d9 -d '<json body>'
```

Example prompt: Search Firmy.cz for 'instalatér' (plumbers) in Brno and Prague, collect up to 200 unique listings across both cities, and enrich each result with company ID, legal form, and formation date from the Czech business register.

## When to prefer this

Use this endpoint when you need structured business listings specifically from the Czech Firmy.cz directory — the dominant Czech business search portal. Prefer this over generic web scrapers when you need deduplicated, ranked Czech business data with optional legal entity enrichment from the Czech ARES business register. Best suited for B2B lead generation, market research, or competitive analysis targeting Czech companies by trade or service category.

## Known failure modes

- No listings found for query returns count:0 with empty items array (not charged)
- Invalid or misspelled Czech city name may return zero results due to strictLocationMatch
- maxPages cap reached before maxItems is fulfilled, truncating results
- ARES enrichment may fail to match companies with unusual name spellings
- Network or scraping errors on Firmy.cz side may result in a failed run (not charged)
- Overly broad queries may hit deduplication limits before reaching maxItems

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of matched companies and an array of business items, each with name, location, company ID (if ARES enrichment enabled), profile URL, search rank, the query that matched it, and which locations and search queries it was associated with. The product field confirms the data source as 'firmy'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "location": {
   "type": "string",
   "description": "Optional city name appended to the search phrase; leave empty for nationwide search."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Hard cap on unique companies across all searches. Zero removes the cap."
  },
  "maxPages": {
   "type": "integer",
   "default": 10,
   "maximum": 250,
   "minimum": 1,
   "description": "Safety limit for search pagination. Each page normally has 14 listings."
  },
  "locations": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Optional list of cities. Each is searched with every query; takes precedence over City or municipality."
  },
  "enrichAres": {
   "type": "boolean",
   "default": false,
   "description": "Look up exact business-name and postal-code matches in the public business register to add company ID, formation date, legal form, and status."
  },
  "searchQuery": {
   "type": "string",
   "description": "Czech business keyword, category, service, or phrase."
  },
  "searchQueries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Multiple keywords to search; takes precedence over Search query when filled."
  },
  "maxResultsPerQuery": {
   "type": "integer",
   "default": 50,
   "maximum": 5000,
   "minimum": 1,
   "description": "Maximum matching listings to collect for each query and city pair before deduplication."
  },
  "strictLocationMatch": {
   "type": "boolean",
   "default": false,
   "description": "Keep only listings whose published locality matches the requested city or a named subdivision."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "location": null,
    "companyId": null,
    "profileUrl": null,
    "searchRank": null,
    "searchQuery": null,
    "matchedLocations": null,
    "matchedSearchQueries": null
   }
  ],
  "product": "firmy"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/firmy-cz-czech-business-directory-scraper-f0c562d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)