{ "openapi": "3.0.1", "info": { "title": "Hilma Finland Scraper — Public Procurement Tenders", "description": "Search and extract Finnish public procurement notices from hankintailmoitukset.fi (Hilma). Filter by keyword, notice type, category, region, or value. Returns buyer info, deadlines, CPV codes, and award winners. No API key, no login required.", "version": "0.0", "x-build-id": "o9nAiUTyJqjivjXRU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~hankintailmoitukset-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-hankintailmoitukset-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/studio-amba~hankintailmoitukset-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-hankintailmoitukset-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/studio-amba~hankintailmoitukset-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-hankintailmoitukset-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": { "searchQuery": { "title": "Keywords", "type": "string", "description": "Search notices by keyword, matched against the title, description, and organisation name (Finnish/Swedish/English). Examples: 'rakentaminen' (construction), 'ohjelmisto' (software), 'terveyspalvelut' (health services), 'siivous' (cleaning)." }, "mainType": { "title": "Notice Type", "enum": [ "all", "ContractNotices", "ContractAwardNotices", "PriorInformationNotices", "ProcurementPlan", "Modification", "NationalNotices" ], "type": "string", "description": "Filter by notice type. 'Contract Notices' = open calls for tenders, 'Contract Award Notices' = completed procurements with winners.", "default": "all" }, "procurementTypeCode": { "title": "Procurement Type", "enum": [ "all", "services", "supplies", "works" ], "type": "string", "description": "Filter by procurement type.", "default": "all" }, "region": { "title": "Region (NUTS code prefix)", "type": "string", "description": "Filter by Finnish NUTS region code prefix. Examples: 'FI1B' (Helsinki-Uusimaa), 'FI1C' (Southwest Finland), 'FI19' (Western Finland), 'FI1D' (Northern & Eastern Finland). Leave empty for all regions." }, "openOnly": { "title": "Open tenders only", "type": "boolean", "description": "Only return notices that are not cancelled and have a submission deadline in the future.", "default": false }, "publishedAfter": { "title": "Published After", "type": "string", "description": "Only notices published on or after this date. Format: YYYY-MM-DD." }, "publishedBefore": { "title": "Published Before", "type": "string", "description": "Only notices published on or before this date. Format: YYYY-MM-DD." }, "estimatedValueMin": { "title": "Minimum Estimated Value (EUR)", "type": "integer", "description": "Only notices with an estimated contract value at or above this amount, in EUR." }, "estimatedValueMax": { "title": "Maximum Estimated Value (EUR)", "type": "integer", "description": "Only notices with an estimated contract value at or below this amount, in EUR." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of notices to return. All fields (including CPV codes, award winners, and full description) come from a single search request — no extra per-item requests needed.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration." } } }, "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 } } } } } } } } } }