{ "openapi": "3.0.1", "info": { "title": "Ireland CRO Company Search Scraper", "description": "Search Ireland's Companies Registration Office (CRO) register. Find companies by name, status, type, county or reg/dissolution date, or look up exact companies by CRO company number. Full company data: status, type, dates, address, Eircode, NACE code.", "version": "1.0", "x-build-id": "VVWjNoPR83jNXgrfA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ireland-cro-company-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ireland-cro-company-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/crawlerbros~ireland-cro-company-search-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ireland-cro-company-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/crawlerbros~ireland-cro-company-search-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ireland-cro-company-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCompanyNumber" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Company name contains", "type": "string", "description": "Free-text company name search (mode=search). Case-insensitive substring match. Leave empty to browse by filters only.", "default": "guinness" }, "companyNumbers": { "title": "CRO company numbers (mode=byCompanyNumber)", "type": "array", "description": "Exact CRO company registration numbers, e.g. `3124`, `279457`.", "default": [], "items": { "type": "string" } }, "companyStatus": { "title": "Company status", "enum": [ "", "Normal", "Dissolved", "Struck Off", "Strike Off Listed", "Liquidation", "Liquidation (UK)", "Liquidation stayed", "Examinership", "Administration", "Administration (UK)", "Ceased", "Ceased IRL", "Dissolved-20 years", "Dissolved PostMerger", "Dissolved by Divis", "Conv. to IndProvSoc", "De-Registered ICAV", "De-Registered Investment Company", "Deleted CB Conversion", "Deleted CB Merger", "Deleted as per SE Tr", "Deleted per SE merge" ], "type": "string", "description": "Filter to an exact company status.", "default": "" }, "companyType": { "title": "Company type", "enum": [ "", "LTD - Private Company Limited by Shares", "DAC - Designated Activity Company (limited by shares)", "DAC - Designated Activity Company (limited by guarantee)", "CLG - Company Limited by Guarantee", "PLC - Public Limited Company", "ULC - Private Unlimited Company", "Single member private company limited by shares", "Private limited by shares", "Private limited by guarantee", "Private unlimited", "Private unlimited with share capital", "Private guarantee with share capital", "Private company with variable capital", "Private, limited by shares, licence to omit ltd", "Public limited company", "Public limited company (closed ended)", "Public limited company with variable capital", "Public unlimited company with a share capital", "Public unlimited company without share capital", "PUC - Public Unlimited Company", "PULC - Public Unlimited Company without share capital", "Guarantee", "Guarantee licence", "Guarantee company without a share capital (public)", "Guarantee licence company w/o sh/capital (public)", "CLG-Company Limited by Guarantee (licenced company)", "DAC- Designated Activity Company (limited by guarantee ) (licenced company)", "DAC-Designated Activity Company (limited by shares) (Licenced Company)", "ULC - Private Unlimited Company (licenced company)", "Single member company ltd by g/tee with sh/cap", "IC - Investment company - Part 24 Companies Act 2014", "UCITS - Undertaking for Collective Investment in Transferable Securities", "U.C.I.T", "European economic interest grouping", "External company", "Foreign Body Corporate making a local offer (B18a)", "Inward Migrating Company", "Societas Europaea - New Incorporation", "Societas Europaea - Formation of Subsidiary", "Societas Europaea - PLC conversion", "Societas Europaea - Transfer into State", "Private", "Public", "Unknown" ], "type": "string", "description": "Filter to an exact company legal type.", "default": "" }, "county": { "title": "County (registered address)", "enum": [ "", "Carlow", "Cavan", "Clare", "Cork", "Donegal", "Dublin", "Galway", "Kerry", "Kildare", "Kilkenny", "Laois", "Leitrim", "Limerick", "Longford", "Louth", "Mayo", "Meath", "Monaghan", "Offaly", "Roscommon", "Sligo", "Tipperary", "Waterford", "Westmeath", "Wexford", "Wicklow" ], "type": "string", "description": "Filter to companies whose registered address mentions this Irish county.", "default": "" }, "naceCode": { "title": "NACE industry code", "type": "string", "description": "Filter to companies with this NACE Rev. 2 principal activity code. Give the full 4-digit class code (`45.20` or `4520`) for an exact match, or just the 2-digit division (`45`) to match every class within that division. Leave empty for no filter.", "default": "" }, "registrationDateFrom": { "title": "Registered on/after (YYYY-MM-DD)", "type": "string", "description": "Only include companies registered on or after this date." }, "registrationDateTo": { "title": "Registered on/before (YYYY-MM-DD)", "type": "string", "description": "Only include companies registered on or before this date." }, "dissolvedDateFrom": { "title": "Dissolved on/after (YYYY-MM-DD)", "type": "string", "description": "Only include companies dissolved on or after this date." }, "dissolvedDateTo": { "title": "Dissolved on/before (YYYY-MM-DD)", "type": "string", "description": "Only include companies dissolved on or before this date." }, "sortBy": { "title": "Sort by", "enum": [ "", "companyNameAsc", "companyNameDesc", "registrationDateDesc", "registrationDateAsc", "dissolvedDateDesc", "statusDateDesc" ], "type": "string", "description": "Sort order for results (mode=search).", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 }, "includeFinancialFilings": { "title": "Include financial statement filing history", "type": "boolean", "description": "Enrich each company with its `financialStatementFilings` array (submission dates for accounts filed with CRO in 2022, 2023, and 2024) from CRO's official Financial Statements open-data feed. Adds extra API calls, so it's off by default.", "default": 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 } } }, "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 } } } } } } } } } }