{ "openapi": "3.0.1", "info": { "title": "Portugal Public Contracts (Portal BASE)", "description": "Search and export Portuguese public contracts from the official Portal BASE open data (IMPIC, dados.gov.pt). Filter by contracting authority or supplier (name or NIF), CPV, procedure type, dates, value and year. Clean JSON/CSV/Excel with ISO dates, euro amounts and separate NIFs.", "version": "0.0", "x-build-id": "qX8se8CEShihPKbSo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fluxopronto~portugal-public-contracts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fluxopronto-portugal-public-contracts", "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/fluxopronto~portugal-public-contracts/runs": { "post": { "operationId": "runs-sync-fluxopronto-portugal-public-contracts", "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/fluxopronto~portugal-public-contracts/run-sync": { "post": { "operationId": "run-sync-fluxopronto-portugal-public-contracts", "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": { "years": { "title": "Years", "type": "array", "description": "Portal BASE year files to scan (2012 to the current year). Files are grouped by contract year (normally the signing year). Leave empty to use the date range, or the latest year if there is no date range.", "items": { "type": "string" } }, "contractingAuthorities": { "title": "Contracting authority (name or NIF)", "type": "array", "description": "Public body that awarded the contract. Enter a 9-digit NIF (most reliable, names are spelled in several ways) or part of the name; case and accents are ignored.", "items": { "type": "string" } }, "suppliers": { "title": "Supplier / winning company (name or NIF)", "type": "array", "description": "Company that won the contract (adjudicatário). 9-digit NIF or part of the name.", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Common Procurement Vocabulary codes. Prefix match: \"72\" = all IT services, \"45\" = all construction work, \"72210000-0\" = programming services and sub-codes.", "items": { "type": "string" } }, "procedureTypes": { "title": "Procedure type", "type": "array", "description": "Part of the procedure type name as published in Portuguese, e.g. \"Ajuste Direto\", \"Consulta Prévia\", \"Concurso público\", \"acordo-quadro\".", "items": { "type": "string" } }, "contractTypes": { "title": "Contract type", "type": "array", "description": "Part of the contract type in Portuguese, e.g. \"Aquisição de serviços\", \"Aquisição de bens móveis\", \"Empreitadas de obras públicas\".", "items": { "type": "string" } }, "keywords": { "title": "Keywords in the contract title/description", "type": "array", "description": "Any of these words or phrases (Portuguese text), case and accents ignored.", "items": { "type": "string" } }, "dateFrom": { "title": "Date from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Inclusive, YYYY-MM-DD. Applies to the field chosen in \"Date field\"." }, "dateTo": { "title": "Date to", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Inclusive, YYYY-MM-DD." }, "dateField": { "title": "Date field", "enum": [ "publicationDate", "signingDate" ], "type": "string", "description": "Which date the date range applies to.", "default": "publicationDate" }, "minPrice": { "title": "Minimum contract price (EUR)", "minimum": 0, "type": "number", "description": "Contract price (preço contratual), in euros, exactly as published on Portal BASE." }, "maxPrice": { "title": "Maximum contract price (EUR)", "minimum": 0, "type": "number", "description": "Contract price, in euros." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops when this many contracts have been saved. You are charged per saved contract.", "default": 1000 } } }, "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 } } } } } } } } } }