{ "openapi": "3.0.1", "info": { "title": "(ANAC) Italian Public Contracts & Tenders Scraper", "description": "Search Italian public procurement (appalti pubblici) by supplier VAT, contracting authority, CIG, CPV, province, date and value. Get tenders, awards and winning suppliers from ANAC open data, 2007 to today, with new awards within hours.", "version": "0.1", "x-build-id": "V8wGRJz14bHM7JD7g" }, "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": { "supplierTaxIds": { "title": "Supplier VAT / tax codes", "type": "array", "description": "Find every contract 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 every tender 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" } }, "searchTerms": { "title": "Keywords", "type": "array", "description": "Keep only contracts whose subject, category or authority name contains any of these words.", "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" } }, "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" }, "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." }, "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 }, "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 }, "maxResults": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many contracts.", "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 } } }, "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 } } } } } } } } } }