Firmy.cz API

Search Firmy.cz for Czech businesses and pull contacts, opening hours, company ids and reviews as JSON.

The API.SH Firmy.cz API turns Firmy.cz, the Czech Republic's business directory, into structured JSON. Search businesses by what you look for, optionally in a place, or browse a category by region, and get each business's website, business phone, address with coordinates, rating and review count. Then open one business for opening hours per day, company id (IČO) and legal form, categories, amenities, social profiles, the reviews shown and its daily menu when it publishes one.

Get a free API key Try it in the playground

2 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Firmy.cz business search

GET https://api.api.sh/firmy/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Firmy.cz API

Czech B2B lead lists

Browse a category in a region and collect business name, website, phone, address and social profiles for sales outreach in the Czech Republic.

/search

Company matching with IČO

Open each business to read its IČO and legal form, so you can match Firmy.cz listings with the Czech business register or your CRM.

/business

Local SEO and listing audits

Check that a chain's branches show the right website, phone, address, opening hours and categories on Firmy.cz.

/search /business

Review and reputation tracking

Pull ratings, review counts and the reviews shown (author, rating, date, text) for your branches and competitors.

/business

Restaurant and daily menu data

Read the menu sections and daily menu restaurants publish on Firmy.cz to build a lunch-menu app or compare prices.

/business

Firmy.cz data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Firmy.cz API endpoints and prices

Every Firmy.cz endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery1

Firmy.cz business search

/firmy/v1/search

$1 · $2 PAYG

1 credit

More data1

Firmy.cz business detail

/firmy/v1/business

$1 · $2 PAYG

1 credit

Call the Firmy.cz API

Firmy.cz business search: GET https://api.api.sh/firmy/v1/search

curl "https://api.api.sh/firmy/v1/search?q=pizzerie" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/firmy/v1/search",
    params={"q": "pizzerie"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/firmy/v1/search");
url.searchParams.set("q", "pizzerie");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/firmy/v1/search", "q", "pizzerie")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Firmy.cz" and "Firmy.cz business search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Firmy.cz data

Public data only: no Firmy.cz login, cookies or account needed
One key and one response shape for Firmy.cz and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Firmy.cz API

Firmy.cz does not publish a public API for its directory; Czech company-data APIs such as Merk cover register data instead. API.SH reads public Firmy.cz pages and returns them as JSON.

Instead of a Firmy.cz scraper from GitHub or an Apify actor built on other sources, call two endpoints with one API.SH key at a fixed price per call.

Firmy.cz API questions

What Firmy.cz data can I get?+

Business search by keyword and place, or by category and region (/firmy/v1/search), and one business with website, phone, address, opening hours, IČO, legal form, categories, amenities, reviews and menu (/firmy/v1/business).

How much does the Firmy.cz API cost?+

Every Firmy.cz endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /firmy/v1/business at 1 credit each.

Is there an official Firmy.cz API?+

No public directory API turned up in our research. API.SH covers the public business listings on Firmy.cz.

Do I need a Firmy.cz account or login?+

No. API.SH reads public Firmy.cz pages only. No endpoint uses a login, cookies or anyone's account.

Does the Firmy.cz API return the IČO?+

Yes. /firmy/v1/business returns the company id (IČO) and legal form when the listing shows them, which makes it easy to join with Czech company databases.

Is there a Firmy.cz scraper on GitHub?+

Some hobby scrapers exist, but they break when the site changes. API.SH keeps the endpoints working, handles blocks and retries for you, and charges a fixed price per call.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /firmy/v1/search with q set to a trade such as autoservis and location set to Praha. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.