{"uid":"cap_FasmExrmzx1h-BUBy5E_V","slug":"czech-business-directory-scraper-firmy-cz-26bda38c","name":"Czech Business Directory Scraper (Firmy.cz)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/firmy?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"name":null,"location":null,"companyId":null,"profileUrl":null,"searchRank":null,"searchQuery":null,"matchedLocations":null,"matchedSearchQueries":null}],"product":"firmy"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GTSGANNxTaefEdS8v8zTK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches and scrapes structured Czech business listings from Firmy.cz by keyword and location, optionally enriching results with public business register (ARES) data.","exampleAgentPrompt":"Search Firmy.cz for 'elektrikář' (electrician) companies in Praha and Brno, collect up to 200 unique listings across up to 20 pages, and enrich the results with ARES business register data so I get company IDs, legal forms, and formation dates.","exampleUseCases":[{"title":"Lead generation for Czech B2B sales","prompt":"I need a list of IT consulting firms across Prague, Brno, and Ostrava from Firmy.cz — search for 'IT konzultace' and 'softwarový vývoj', cap it at 300 unique companies, and enrich everything with ARES so I have company IDs and legal status."},{"title":"Local competitor research in Czech market","prompt":"Find all yoga studios listed on the Czech business directory in Praha and filter strictly to listings actually located there — search 'jóga studio', get up to 50 results per query, and give me their profile URLs and search rankings."},{"title":"Nationwide Czech franchise location mapping","prompt":"Search Firmy.cz for 'rychlé občerstvení' nationwide without specifying a city, grab up to 500 unique listings across 25 pages, and include ARES enrichment so I can see each company's legal form and formation date."}],"resultDescription":"A JSON object with a count of matched companies and an array of items, each containing company name, location, company ID, profile URL, search rank, matched search query, matched locations, and matched search queries. With ARES enrichment enabled, items also include legal form, formation date, and business status.","failureModes":["No results found for given keyword/location combination — returns empty items array (not charged)","Rate limiting or blocking by Firmy.cz — may return failed run (not charged)","Invalid or unsupported Czech city name — may return zero results or unfiltered results","maxPages or maxItems too low — truncated result set","strictLocationMatch excludes most listings if locality names differ from requested city spelling"],"whenToPreferThis":"Choose this endpoint when you need structured data specifically from the Czech Firmy.cz business directory, especially for lead generation, competitor analysis, or market research in Czech Republic. Prefer it over generic web scrapers when you need deduplicated, paginated Czech business listings with optional ARES business register enrichment in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:20.709Z","isFirstParty":false,"canonicalSlug":"czech-business-directory-scraper-firmy-cz-26bda38c"}