{ "openapi": "3.0.1", "info": { "title": "Firmy.cz Scraper", "description": "[💰 $4.0 / 1K] Extract Czech business listings from Firmy.cz — name, address, phone, website, email, rating, opening hours, IČO, photos, geo coordinates, and more. Search by keyword + city, browse by category, or paste Firmy.cz URLs directly.", "version": "1.2", "x-build-id": "dDZNA3ZEtUybLycgW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~firmy-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-firmy-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~firmy-search-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-firmy-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~firmy-search-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-firmy-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchUrls": { "title": "Firmy.cz URLs", "type": "array", "description": "Paste one or more Firmy.cz search-result URLs (e.g. https://www.firmy.cz/?q=restaurace&x=14.42076&y=50.087811&rt=mesto). When provided, these override the guided search fields below.", "items": { "type": "string" } }, "searchQuery": { "title": "Search Keyword", "type": "string", "description": "Free-text keyword to search (e.g. \"restaurace\", \"zubař\", \"autoservis\"). Searches all of Czech Republic by default unless a city is given below. Leave this empty if you want to browse a category below. Ignored when URLs are provided above." }, "location": { "title": "City or Area", "type": "string", "description": "Czech city or area to scope the search to (e.g. \"Praha\", \"Brno\", \"Plzeň\"). Leave empty to search nationwide. Ignored when URLs are provided above." }, "category": { "title": "Category", "enum": [ "all", "restauracni-sluzby", "auto-moto", "elektro-mobily-pocitace", "obchody", "sluzby-a-remesla", "dum-byt-zahrada", "zdravotnictvi", "zdravi-krasa", "banky-finance", "cestovni-sluzby", "instituce-urady", "vse-pro-firmy", "velkoobchod-vyroba" ], "type": "string", "description": "Browse a real Firmy.cz category instead of typing a keyword — you get everything Firmy.cz files under that category, not everything that happens to match a word. Covers all 12 of the site's top-level categories, plus Beauty & Body Care (a section inside Services & Trades, since Firmy.cz has no top-level beauty category). Leave the search keyword above EMPTY when you pick a category — the two are alternatives, not filters that stack. If both are set the keyword wins, the category is skipped, and the run log and status message say so. Also ignored when URLs are provided.", "default": "all" }, "includeDetails": { "title": "Include Detail-Page Data", "type": "boolean", "description": "Visit each business's detail page to enrich the row with IČO, Datová schránka, business email, the full 7-day opening-hours table, social links, amenities, full description, and additional photos. Best-effort: if firmy.cz's consent gate refuses on a given run, the actor still returns full listing-tier data (name, address, phone, rating, geo, primary photo) and you'll see a one-line note that the detail-tier fields stayed empty for that run. Slower (one extra request per business).", "default": false }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of results to fetch across all sources. Default 200 — increase for bigger runs, or set to 0 for unlimited (capped at 50,000 per run as a safety limit). You are never charged for more than this number: if a page carries extra listings past your limit, the surplus is dropped before it reaches your dataset.", "default": 200 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }