{ "openapi": "3.0.1", "info": { "title": "Bakeca Property Scraper", "description": "Scrape Bakeca.it housing ads across 107 Italian provinces: rooms, rentals, homes for sale, land and commercial. Price, m², GPS, private or agency, phone.", "version": "1.0", "x-build-id": "mupUkOBUWNmDh54P7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~bakeca-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-bakeca-property-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/sian.agency~bakeca-property-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-bakeca-property-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/sian.agency~bakeca-property-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-bakeca-property-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": { "operation": { "title": "🎯 Mode", "enum": [ "search", "detail" ], "type": "string", "description": "Property Search reads Bakeca results pages. Property Detail opens the ad addresses you paste in Ad URLs.", "default": "search" }, "city": { "title": "📍 Province", "enum": [ "italia", "agrigento", "alessandria", "ancona", "aosta", "arezzo", "ascoli", "asti", "avellino", "bari", "barletta", "belluno", "benevento", "bergamo", "biella", "bologna", "bolzano", "brescia", "brindisi", "cagliari", "caltanissetta", "campobasso", "caserta", "catania", "catanzaro", "chieti", "como", "cosenza", "cremona", "crotone", "cuneo", "enna", "fermo", "ferrara", "firenze", "foggia", "forli", "frosinone", "genova", "gorizia", "grosseto", "imperia", "isernia", "laquila", "laspezia", "latina", "lecce", "lecco", "livorno", "lodi", "lucca", "macerata", "mantova", "massa", "matera", "messina", "milano", "modena", "monza", "napoli", "novara", "nuoro", "oristano", "padova", "palermo", "parma", "pavia", "perugia", "urbino", "pescara", "piacenza", "pisa", "pistoia", "pordenone", "potenza", "prato", "ragusa", "ravenna", "reggiocalabria", "reggioemilia", "rieti", "rimini", "roma", "rovigo", "salerno", "sassari", "savona", "siena", "siracusa", "sondrio", "sudsardegna", "taranto", "teramo", "terni", "torino", "trapani", "trento", "treviso", "trieste", "udine", "varese", "venezia", "verbania", "vercelli", "verona", "vibovalentia", "vicenza", "viterbo" ], "type": "string", "description": "The Bakeca province to search. Each one covers its whole province, the capital and the surrounding towns. All of Italy reads the national results.", "default": "milano" }, "category": { "title": "🏠 Section", "enum": [ "rent", "sale", "rooms", "holiday", "commercial", "garages", "warehouses", "land" ], "type": "string", "description": "Which Bakeca housing section to read. Rooms covers single and double rooms and beds in shared flats.", "default": "rent" }, "town": { "title": "🏘️ Town (optional)", "type": "string", "description": "A town inside the province, written as Bakeca writes it, for example Sesto San Giovanni in Milano or Guidonia Montecelio in Roma. Leave empty for the whole province. Ads from other towns are skipped and never billed." }, "sellerType": { "title": "🙋 Advertiser", "enum": [ "any", "private", "agency" ], "type": "string", "description": "Bakeca's own private or agency filter. Each row also carries the advertiser type, so you can split them afterwards.", "default": "any" }, "maxResults": { "title": "🔢 Properties to collect", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many ads to return. One results page holds 25. Free accounts stop at 25.", "default": 50 }, "includeDetails": { "title": "📄 Open each ad in full", "type": "boolean", "description": "Opens every ad for the full description, every photo, the phone number where the ad shows one, district, furnishing, energy class, publish date and the advertiser's profile. Billed as one Property Detail on top of the search row.", "default": false }, "searchUrls": { "title": "🔗 Search page URLs", "type": "array", "description": "Paste Bakeca results pages instead of using the fields above, for example https://milano.bakeca.it/annunci/offro-camera/quartiere/bocconi-ticinese/ . One URL per line. Sorted result pages are not supported.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingUrls": { "title": "🔗 Ad URLs", "type": "array", "description": "For Property Detail: Bakeca ad addresses, for example https://milano.bakeca.it/dettaglio/offro-camera/singola-con-bagno-in-comune-per-universitari-zona-politecnico-vd6a281659042 . One per line.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }