{"uid":"cap_lz7l4YItTcUaHNyVFQAGX","slug":"firmy-cz-czech-business-directory-scraper-f0c562d9","name":"Firmy.cz Czech Business Directory Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/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_6uaVOLigyUZVThPxhL6RW","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":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Czech city business lead generation","prompt":"Find all accounting firms listed on Firmy.cz in Ostrava and Olomouc — I need up to 150 unique results with their profile URLs and search rankings."},{"title":"Nationwide Czech trade directory scrape","prompt":"Search Firmy.cz nationwide for 'elektrikář' and 'elektroinstalace' and give me up to 300 deduplicated electrician businesses with no city filter."},{"title":"Czech company enrichment with business register","prompt":"Pull all 'stavební firma' (construction companies) in Prague from Firmy.cz, cap it at 100 results, and look up each one in the public business register so I get their company ID, legal form, and when they were founded."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:07.154Z","isFirstParty":false,"canonicalSlug":"firmy-cz-czech-business-directory-scraper-f0c562d9"}