{ "openapi": "3.0.1", "info": { "title": "(ANAC) Italian Public Contracts & Tenders Scraper", "description": "Search Italian public procurement by supplier VAT, contracting authority, CIG, CPV, province, date and value. Export available tenders, awards and winning suppliers from official ANAC data, with provenance and freshness information.", "version": "0.1", "x-build-id": "hi8cNjc0QLAsInFZL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/monkey.d.scraping~italian-public-contracts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-monkey.d.scraping-italian-public-contracts-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/monkey.d.scraping~italian-public-contracts-scraper/runs": { "post": { "operationId": "runs-sync-monkey.d.scraping-italian-public-contracts-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/monkey.d.scraping~italian-public-contracts-scraper/run-sync": { "post": { "operationId": "run-sync-monkey.d.scraping-italian-public-contracts-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": { "provinces": { "title": "Provinces", "type": "array", "description": "Keep only contracts located in these Italian provinces, for example MILANO or ROMA.", "default": [ "MILANO" ], "items": { "type": "string" } }, "period": { "title": "Time period", "enum": [ "7d", "30d", "3m", "6m", "12m", "24m", "36m" ], "type": "string", "description": "How far back to search. This is the setting that decides how long a run takes: a week returns in a minute or two, a year takes considerably longer. Start small and widen it only if you need more history.", "default": "7d" }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many contracts.", "default": 1000 }, "searchTerms": { "title": "Keywords", "type": "array", "description": "Keep only contracts whose subject, category or authority name contains any of these words.", "items": { "type": "string" } }, "supplierTaxIds": { "title": "Supplier VAT / tax codes", "type": "array", "description": "Find available contracts awarded to these companies. Enter Italian VAT numbers (partita IVA) or tax codes (codice fiscale), one per line. Note: this searches by award date, and takes longer than the other searches.", "items": { "type": "string" } }, "contractingAuthorityTaxIds": { "title": "Contracting authority tax codes", "type": "array", "description": "Find available tenders published by these public bodies. Enter the tax code (codice fiscale) of the authority, one per line.", "items": { "type": "string" } }, "cigCodes": { "title": "CIG codes", "type": "array", "description": "Look up specific contracts by their CIG code (Codice Identificativo Gara).", "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "Filter by CPV category. A short code selects the whole family: 45 covers all construction works, 331 covers medical devices.", "items": { "type": "string" } }, "minAmount": { "title": "Minimum value (EUR)", "minimum": 0, "type": "integer", "description": "Keep only contracts worth at least this amount." }, "maxAmount": { "title": "Maximum value (EUR)", "minimum": 0, "type": "integer", "description": "Keep only contracts worth at most this amount." }, "onlyPnrr": { "title": "Only NRRP-funded contracts", "type": "boolean", "description": "Keep only contracts flagged as funded by the Italian National Recovery and Resilience Plan.", "default": false }, "dateFrom": { "title": "Published from", "type": "string", "description": "Optional exact start date, as YYYY-MM-DD. Overrides the time period above. Records are available from 2007 onwards." }, "dateTo": { "title": "Published to", "type": "string", "description": "Optional exact end date, as YYYY-MM-DD." }, "includeAwardDetails": { "title": "Include award outcome and winning suppliers", "type": "boolean", "description": "Adds the award value, discount, number of bidders and the winning companies. Turn off for a faster, lighter run when you only need the tender details.", "default": true } } }, "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 } } } } } } } } } }