{ "openapi": "3.0.1", "info": { "title": "ARES Scraper — Czech Company Register (IČO, DIČ, NACE, address)", "description": "Search the official Czech business register ARES by IČO list, company name, legal form, CZ-NACE code, address or region. Get IČO, DIČ, legal form, seat address, NACE codes, registry statuses and dates as clean JSON. No browser, pay per result.", "version": "0.1", "x-build-id": "uD2eeadygQuFNWn7M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eudatalab~ares-cz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eudatalab-ares-cz-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/eudatalab~ares-cz-scraper/runs": { "post": { "operationId": "runs-sync-eudatalab-ares-cz-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/eudatalab~ares-cz-scraper/run-sync": { "post": { "operationId": "run-sync-eudatalab-ares-cz-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": { "icos": { "title": "IČO list (direct lookup)", "type": "array", "description": "Czech company IDs (IČO) to look up, e.g. 27082440 or 6947 (leading zeros are added). Up to thousands per run, fetched 100 per request. When this list is set, all search filters below are ignored.", "items": { "type": "string" } }, "companyName": { "title": "Company name", "type": "string", "description": "Words in the registered business name, e.g. \"pekárna\", \"software\", \"Škoda\". Case- and diacritics-insensitive." }, "naceCodes": { "title": "CZ-NACE activity codes", "type": "array", "description": "Economic activity codes (CZ-NACE 2025), e.g. 10710 (bread and pastry), 62 (IT services), 4120 (construction) or a section letter like F. A code also matches every finer code under it. Subjects match if they registered ANY of the codes.", "items": { "type": "string" } }, "legalForms": { "title": "Legal form", "type": "array", "description": "Leave empty for all. 112 = s.r.o. (LLC), 121 = a.s. (joint-stock), 101 = sole trader.", "items": { "type": "string", "enum": [ "101", "105", "107", "111", "112", "113", "115", "116", "117", "118", "121", "141", "145", "151", "161", "205", "301", "313", "325", "326", "331", "352", "353", "361", "381", "391", "421", "422", "423", "424", "425", "426", "501", "521", "541", "601", "641", "661", "704", "705", "706", "707", "708", "711", "715", "721", "722", "723", "733", "734", "736", "741", "745", "751", "761", "771", "801", "804", "901", "906", "907", "908", "911", "921", "922", "931", "932", "933", "936", "941", "950", "951", "952", "960" ], "enumTitles": [ "101 – Sole trader (trade licence) (Fyzická osoba podnikající dle živnostenského zákona)", "105 – Sole trader (other than trade licence) (Fyzická osoba podnikající dle jiných zákonů než živnostenského a zákona o zemědělství)", "107 – Sole trader (agriculture) (Zemědělský podnikatel - fyzická osoba)", "111 – General partnership (v.o.s.) (Veřejná obchodní společnost)", "112 – Limited liability company (s.r.o.) (Společnost s ručením omezeným)", "113 – Limited partnership (k.s.) (Společnost komanditní)", "115 – Společný podnik", "116 – Zájmové sdružení", "117 – Foundation (Nadace)", "118 – Endowment fund (Nadační fond)", "121 – Joint-stock company (a.s.) (Akciová společnost)", "141 – Public benefit company (o.p.s.) (Obecně prospěšná společnost)", "145 – Association of unit owners (SVJ) (Společenství vlastníků jednotek)", "151 – Komoditní burza", "161 – Institute (ústav) (Ústav)", "205 – Cooperative (družstvo) (Družstvo)", "301 – State enterprise (Státní podnik)", "313 – Česká národní banka", "325 – Organisational unit of the state (Organizační složka státu)", "326 – Stálý rozhodčí soud", "331 – Contributory organisation (Příspěvková organizace)", "352 – Státní organizace Správa železnic", "353 – Rada pro veřejný dohled nad auditem", "361 – Veřejnoprávní instituce (ČT,ČRo,ČTK)", "381 – Fond (ze zákona)", "391 – Zdravotní pojišťovna", "421 – Branch of a foreign company (Odštěpný závod zahraniční právnické osoby)", "422 – Organizační složka zahraničního nadačního fondu", "423 – Organizační složka zahraniční nadace", "424 – Foreign natural person (Zahraniční fyzická osoba)", "425 – Odštěpný závod zahraniční fyzické osoby", "426 – Zastoupení zahraniční banky", "501 – Odštěpný závod nebo jiná organizační složka podniku zapisující se do obchodního rejstříku", "521 – Samostatná drobná provozovna obecního úřadu", "541 – Podílový, penzijní fond", "601 – Vysoká škola (veřejná, státní)", "641 – School legal entity (Školská právnická osoba)", "661 – Veřejná výzkumná instituce", "704 – Zvláštní organizace pro zastoupení českých zájmů v mezinárodních nevládních organizacích", "705 – Podnik nebo hospodářské zařízení sdružení", "706 – Association (spolek) (Spolek)", "707 – Odborová organizace", "708 – Organizace zaměstnavatelů", "711 – Politická strana, politické hnutí", "715 – Podnik nebo hospodářské zařízení politické strany", "721 – Církve a náboženské společnosti", "722 – Evidované církevní právnické osoby", "723 – Svazy církví a náboženských společností", "733 – Organizační jednotka odborové organizace a organizace zaměstnavatelů", "734 – Organizační jednotka zvláštní organizace pro zastoupení českých zájmů v mezinárodních nevládních organizacích", "736 – Branch association (pobočný spolek) (Pobočný spolek)", "741 – Stavovská organizace - profesní komora", "745 – Komora (s výjimkou profesních komor)", "751 – Zájmové sdružení právnických osob", "761 – Honební společenstvo", "771 – Dobrovolný svazek obcí", "801 – Municipality (Obec nebo městská část hlavního města Prahy)", "804 – Region (Kraj a hl.m.Praha)", "901 – Zastupitelský orgán jiných států", "906 – Zahraniční spolek", "907 – Mezinárodní odborová organizace", "908 – Mezinárodní organizace zaměstnavatelů", "911 – Zahraniční kulturní, informační středisko, rozhlasová, tisková a televizní agentura", "921 – Mezinárodní nevládní organizace", "922 – Organizační jednotka mezinárodní nevládní organizace", "931 – Evropské hospodářské zájmové sdružení", "932 – European company (SE) (Evropská společnost)", "933 – Evropská družstevní společnost", "936 – Zahraniční pobočný spolek", "941 – Evropské seskupení pro územní spolupráci", "950 – Subjekt právním řádem výslovně neupravený", "951 – Mezinárodní vojenská organizace vzniklá na základě mezinárodní smlouvy", "952 – Konsorcium evropské výzkumné infrastruktury", "960 – Právnická osoba zřízená zvláštním zákonem zapisovaná do veřejného rejstříku" ] } }, "municipality": { "title": "Municipality / address", "type": "string", "description": "Full-text match on the registered seat address: a municipality (Brno, Plzeň), a Prague district (Praha 5), a street, or a postal code (60200). Fuzzy: \"Praha 5\" can also match other Prague addresses containing a 5." }, "region": { "title": "Region (kraj)", "enum": [ "", "praha", "stredocesky", "jihocesky", "plzensky", "karlovarsky", "ustecky", "liberecky", "kralovehradecky", "pardubicky", "vysocina", "jihomoravsky", "olomoucky", "zlinsky", "moravskoslezsky" ], "type": "string", "description": "Only subjects whose registered seat is in this region. Uses the region's tax offices on the ARES side (subjects with no tax office are not found by this filter)." }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many companies. Each company is one charged event, so this is also your cost cap. The form prefills 25 for a quick first run. ARES answers at most 1 000 per search; bigger searches are split automatically by tax office.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "ARES is an open government API and does not need a proxy. Leave off unless you have a reason.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }