{ "openapi": "3.0.1", "info": { "title": "Subito Auto Scraper", "description": "Scrape used cars from subito.it (Auto category) with structured filters (make, model, region, price, fuel). Returns price, mileage, year, location, and listing URL.", "version": "0.1", "x-build-id": "2DpzL9LHGKfWJ1yhT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~subito-auto-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-subito-auto-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/dadhalfdev~subito-auto-scraper/runs": { "post": { "operationId": "runs-sync-dadhalfdev-subito-auto-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/dadhalfdev~subito-auto-scraper/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-subito-auto-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", "required": [ "max_cars" ], "properties": { "input_url": { "title": "Input URL", "type": "string", "description": "Paste a Subito Auto search URL to use instead of the filters below — overrides all structured filters when set. Leave empty to use the filters below (better for AI agents)." }, "make": { "title": "Make", "enum": [ "", "ABARTH", "AC", "ACM", "AIMA", "AIWAYS", "AIXAM", "ALFA ROMEO", "ALKÈ", "ALPINA-BMW", "ALPINE", "Altro", "AMG", "ANDORIA MOTOR", "APAL", "ARIEL", "ARO", "ASIA MOTORS", "ASTON MARTIN", "AUDI", "AUSTIN ROVER", "AUTOBIANCHI", "AUVERLAND", "B-ON", "BAW", "BEDFORD", "BELLIER", "BENTLEY", "BENTU", "BERTONE", "BIAGINI", "BIRBA", "BMW", "BONETTI", "BOXEL", "BREMACH", "BSI", "BUCHER-SCHORLING", "BUGATTI", "BUICK", "BYD", "CADILLAC", "CARLETTI", "CASALINI", "CATERHAM", "CENNTRO", "CHANGAN", "CHATENET", "CHEVROLET", "CHRYSLER", "CIRELLI", "CITROEN", "CITYCAR", "CMC (CARLETTI)", "CMI", "CO.VE.IN.", "COMAI", "CORVETTE", "CUPRA", "DACIA", "DAEWOO", "DAF", "DAIHATSU", "DAIMLER", "DALLARA", "DE LA CHAPELLE", "DE TOMASO", "DFSK", "DODGE", "DONGFENG", "DONKERVOORT", "DR", "DS", "DUCATI ENERGIA", "EFFEDI", "ELI", "EMC", "EPOCAR", "ESTRIMA", "EVANTE", "EVO", "EVUM MOTORS", "FEAB", "FERRARI", "FIAT", "FISKER", "FLEUR DE LYS", "FORD", "FORTHING", "FOTON", "FRESIA", "FSO", "GAC GONOW", "GAZ AUTOMOBILE", "GEELY", "GEM", "GINETTA", "GIOTTI VICTORIA", "GIOTTILINE", "GOUPIL", "GREAT WALL MOTOR", "GRECAV", "GREEN COMPANY", "HAVAL", "HEIBAO ITALIA", "HONDA", "HUMMER", "HYUNDAI", "I MOVING", "I.CO.VE.CO.", "IATO", "ICH-X", "INEOS", "INFINITI", "INNOCENTI", "INTRALL POLSKA", "ISO", "ISUZU", "ITALCAR", "IVECO", "JAECOO", "JAGUAR", "JDM", "JEEP", "JINPENG", "KATAY", "KGM", "KIA", "KTM", "LADA", "LAMBORGHINI", "LANCIA", "LAND ROVER", "LEAPMOTOR", "LEM", "LEOMAR", "LEXUS", "LIGIER", "LOTUS", "LUAZ (VOLIN)", "LYNK&CO", "MAHINDRA", "MAN", "MARCOS", "MARTIN MOTORS", "MARUTI", "MASERATI", "MAXUS", "MAYBACH", "MAZDA", "MAZZANTI", "MAZZIERI", "MCLAREN", "MEGA", "MELEX", "MERCEDES", "META", "MG", "MIA ELECTRIC", "MICRO VETT", "MICROCAR", "MICROLINO", "MIDDLEBRIDGE", "MILITEM", "MINAUTO", "MINI", "MITSUBISHI", "MITSUBISHI FUSO", "MITSUBISHI TRUCKS", "MOBILIZE", "MOKE", "MORETTI", "MORGAN", "MORONI", "MPM MOTORS", "MULTICAR", "MUSTANG", "NANOCAR", "NEXTEM", "NISSAN", "NISSAN SPAGNA", "NOBLE", "NYSA", "NYSA MOTOR", "O.ZETA CLES", "OHM", "OLTCIT", "OMAI", "OMODA", "OPEL", "OTO MELARA", "P.G.O.", "PAGANI", "PANTHER", "PEUGEOT", "PIAGGIO", "POCCO", "POLESTAR", "PONTIAC", "PORSCHE", "PUMA ITALIA", "QVALE", "RAP", "RAYTON FISSORE", "REGIS", "RENAULT", "RENAULT TRUCKS", "RENAULT V.I.", "ROLLS ROYCE", "ROMANITAL", "ROMEO FERRARIS", "ROVER", "SAAB", "SALEEN", "SANTANA", "SAVEL-ERAD", "SCAM", "SEAT", "SECA", "SECMA", "SERES", "SEVIC", "SHINERAY", "SHUANGHUAN", "SILENCE", "SKODA", "SMART", "SPORTEQUIPE", "SSANGYONG", "START LAB", "SUBARU", "SUZUKI", "SWAPA", "SWM", "TALBOT", "TASSO", "TATA", "TAZZARI EV", "TESLA", "TIGER", "TODAY SUNSHINE", "TORPEDO", "TOWN LIFE", "TOYOTA", "TVR", "UAZ", "UMM", "VALENTINI", "VEM", "VENTURI", "VOLGA", "VOLKSWAGEN", "VOLKSWAGEN MESSICO", "VOLVO", "VOYAH", "WULING", "XEV", "XINDAYANG", "XPENG", "YUGO", "ZAZ", "ZD", "ZK" ], "type": "string", "description": "Car brand as on Subito (fetched from Subito's live brands API). Leave empty for all brands. Ignored when input_url is set.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Optional model (e.g. Panda, Golf, Serie 3). Free text — only used when `make` is also set; ignored otherwise. Ignored when input_url is set." }, "query": { "title": "Keywords", "type": "string", "description": "Optional free-text keywords (e.g. neopatentati, hybrid). Ignored when input_url is set." }, "region": { "title": "Region", "enum": [ "", "Valle d'Aosta", "Piemonte", "Liguria", "Lombardia", "Trentino-Alto Adige", "Veneto", "Friuli-Venezia Giulia", "Emilia-Romagna", "Toscana", "Umbria", "Lazio", "Marche", "Abruzzo", "Molise", "Campania", "Puglia", "Basilicata", "Calabria", "Sardegna", "Sicilia" ], "type": "string", "description": "Italian region. Empty = nationwide. Ignored when input_url is set.", "default": "" }, "city": { "title": "City / province", "type": "string", "description": "Optional city or province name (e.g. Milano, Roma). Ignored when input_url is set." }, "condition": { "title": "Vehicle condition", "enum": [ "", "Usato", "Km0", "Nuovo" ], "type": "string", "description": "Vehicle condition filter. Ignored when input_url is set.", "default": "" }, "body_type": { "title": "Body type", "enum": [ "", "Utilitaria", "Berlina", "Station Wagon", "Monovolume", "SUV/Fuoristrada", "Cabrio", "Coupé", "City Car", "Altro" ], "type": "string", "description": "Body style filter. Ignored when input_url is set.", "default": "" }, "price_min": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price in euros. Ignored when input_url is set." }, "price_max": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price in euros. Ignored when input_url is set." }, "mileage_min": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage in km. Ignored when input_url is set." }, "mileage_max": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage in km. Ignored when input_url is set." }, "year_min": { "title": "Min year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Minimum registration year. Ignored when input_url is set." }, "year_max": { "title": "Max year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Maximum registration year. Ignored when input_url is set." }, "energy": { "title": "Fuel / energy", "enum": [ "", "Benzina", "Diesel", "Gpl", "Elettrica", "Ibrida", "Mild Hybrid Benzina", "Mild Hybrid Diesel", "Full Hybrid Benzina", "Full Hybrid Diesel", "PHEV - Ibrido Plug-in Benzina", "PHEV - Ibrido Plug-in Diesel", "Metano", "Altro" ], "type": "string", "description": "Fuel type. Ignored when input_url is set.", "default": "" }, "gearbox": { "title": "Gearbox", "enum": [ "", "Manuale", "Automatico", "Sequenziale", "Altro" ], "type": "string", "description": "Transmission. Ignored when input_url is set.", "default": "" }, "seller_type": { "title": "Seller type", "enum": [ "", "Privato", "Azienda" ], "type": "string", "description": "Private or dealer seller. Ignored when input_url is set.", "default": "" }, "sort_by": { "title": "Sort by", "enum": [ "Most Recent", "Most Relevant", "Lowest Price", "Highest Price", "Newest Year", "Oldest Year", "Lowest KM", "Highest KM", "Lowest Power", "Highest Power", "Shortest Length", "Longest Length" ], "type": "string", "description": "How to order the results.", "default": "Most Recent" }, "max_cars": { "title": "Max cars", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum listings to return per run (1–2000).", "default": 50 }, "enrich_details": { "title": "Enrich details", "type": "boolean", "description": "If true, open each ad page for extra fields (usually unnecessary — search results already include rich vehicle data).", "default": false }, "listing_urls": { "title": "Listing URLs", "type": "array", "description": "Optional direct ad URLs. If set without search filters, only these are scraped.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }