{ "openapi": "3.0.1", "info": { "title": "Subito Product Search Scraper", "description": "Unlock valuable product data from Italy's leading marketplace with the Subito.it product Scraper. Extract comprehensive product listings from Naples and other Italian regions, including pricing, specifications, seller details, and images. Perfect for dealers, market researchers in used car market.", "version": "0.0", "x-build-id": "pyxqjPAI6FcXMjvCh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ecomscrape~subito-automotive-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ecomscrape-subito-automotive-search-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/ecomscrape~subito-automotive-search-scraper/runs": { "post": { "operationId": "runs-sync-ecomscrape-subito-automotive-search-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/ecomscrape~subito-automotive-search-scraper/run-sync": { "post": { "operationId": "run-sync-ecomscrape-subito-automotive-search-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": { "urls": { "title": "URLs of the product list page urls to scrape", "type": "array", "description": "Add the URLs of the product list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Ignore URL failures", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached." }, "keyword": { "title": "Keyword to search", "type": "string", "description": "Enter the keyword to search for items" }, "category": { "title": "Category to search", "enum": [ "usato", "auto", "accessori-auto", "moto-e-scooter", "accessori-moto", "nautica", "caravan-e-camper", "veicoli-commerciali", "appartamenti", "camere-posti-letto", "ville-singole-e-a-schiera", "terreni-e-rustici", "garage-e-box", "loft-mansarde", "case-vacanza", "uffici-locali-commerciali", "offerte-lavoro", "servizi", "cerco-lavoro", "attrezzature", "informatica", "videogiochi", "audio-video", "fotografia", "telefonia", "arredamento-casalinghi", "elettrodomestici", "giardino-fai-da-te", "abbigliamento-accessori", "bambini-giocattoli", "animali", "accessori-per-animali", "musica-film", "libri-riviste", "strumenti-musicali", "sport", "biciclette", "hobby-collezionismo", "annunci-vari" ], "type": "string", "description": "Enter the category to search for items" }, "min_price": { "title": "Filter Items by Minimum Price", "enum": [ "", "30", "50", "100", "150", "200", "500", "1000", "1500", "2000" ], "type": "string", "description": "Filter items by Minimum Price" }, "max_price": { "title": "Filter Items by Maximum Price", "enum": [ "", "30", "50", "100", "150", "200", "500", "1000", "1500", "2000" ], "type": "string", "description": "Filter items by Maximum Price" }, "condition": { "title": "Filter Items by Condition", "enum": [ "", "10", "20", "30", "40", "50" ], "type": "string", "description": "Filter items by Condition" }, "sort_by": { "title": "Filter Items by Sort By", "enum": [ "", "datedesc", "priceasc", "pricedesc" ], "type": "string", "description": "Filter items by Sort By" }, "page": { "title": "Page start", "type": "integer", "description": "Specify the page number to start scraping from" }, "max_items_per_url": { "title": "Limit the number of items per URL or search filters", "type": "integer", "description": "Limit the number of items per URL or search filters you want to scrape" }, "max_retries_per_url": { "title": "Limit the number of retries", "type": "integer", "description": "Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load" }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your scraper." } } }, "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 } } } } } } } } } }