{ "openapi": "3.0.1", "info": { "title": "Subito Scraper - Italian Listings, Prices & Sellers", "description": "Scrape public Subito.it listings by keyword or search URL. Get prices, condition, photos, descriptions, locations, seller and shipping fields. Filter by category, region, province and price. Paginated JSON, CSV or Excel exports.", "version": "0.1", "x-build-id": "zxlX542dIKHNSQPSp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~subito-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-subito-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/s-r~subito-scraper/runs": { "post": { "operationId": "runs-sync-s-r-subito-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/s-r~subito-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-subito-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": { "query": { "title": "Query", "maxLength": 500, "type": "string", "description": "Search keyword, for example iphone 13. Provide query or search_url." }, "search_url": { "title": "Search url", "type": "string", "description": "Paste a public Subito /annunci- search URL. Its query and filters take precedence." }, "category": { "title": "Category", "type": "string", "description": "Category slug or id from Subito, such as telefonia or 12." }, "region": { "title": "Region", "type": "string", "description": "Italian region slug or id, such as lombardia or 4." }, "province": { "title": "Province", "type": "string", "description": "Province slug within region, such as bergamo. Requires region." }, "ad_type": { "title": "Ad type", "enum": [ "for_sale", "giveaway", "for_rent", "holiday_rent", "wanted" ], "type": "string", "description": "Type of classified ad.", "default": "for_sale" }, "price_min": { "title": "Price min", "minimum": 0, "type": "integer", "description": "Minimum asking price in EUR." }, "price_max": { "title": "Price max", "minimum": 0, "type": "integer", "description": "Maximum asking price in EUR." }, "condition": { "title": "Condition", "enum": [ "new", "like_new", "excellent", "good", "damaged" ], "type": "string", "description": "Condition filter. Output keeps the original Italian label." }, "seller_type": { "title": "Seller type", "enum": [ "all", "private", "business" ], "type": "string", "description": "Include all sellers, private sellers or businesses.", "default": "all" }, "shipping_only": { "title": "Shipping only", "type": "boolean", "description": "Only listings that offer shipping.", "default": false }, "title_only": { "title": "Title only", "type": "boolean", "description": "Search only listing titles.", "default": false }, "sort": { "title": "Sort", "enum": [ "newest", "relevance", "price_asc", "price_desc" ], "type": "string", "description": "Result order. Listings without a price may come first with price_asc.", "default": "newest" }, "max_items": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum unique listings. Apify follows cursors automatically; API clients follow next_cursor.", "default": 100 }, "cursor": { "title": "Cursor", "maxLength": 16384, "type": "string", "description": "Opaque next_cursor from a previous response for the same search and filters." } } }, "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 } } } } } } } } } }