{ "openapi": "3.0.1", "info": { "title": "Standvirtual Listings Scraper", "description": "Scrape Standvirtual.com car listings (carros usados) by filters or search URL: price, full specs, equipment, seller and district for cars, motorcycles, vans and trucks. Optional seller phone numbers, VIN, description and photos. No page cap, no duplicates.", "version": "0.0", "x-build-id": "ocoGkscLupMd1Eu0h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~standvirtual-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-standvirtual-listings-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/piotrv1001~standvirtual-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-standvirtual-listings-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/piotrv1001~standvirtual-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-standvirtual-listings-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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "Standvirtual search result URLs, copied from your browser after setting filters on standvirtual.com, e.g. https://www.standvirtual.com/carros/bmw/desde-2018?search%5Bfilter_enum_engine_code%5D=serie-3&search%5Bfilter_enum_fuel_type%5D=diesel. Every filter, the sort order and the page number in the URL are kept. When you add URLs, the filter fields below are ignored.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "cars", "motorcycles", "vans", "trucks", "motorhomes", "boats" ], "type": "string", "description": "Vehicle category to search when no search URLs are given. Defaults to passenger cars." }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search, e.g. \"tesla model 3\" or \"teto de abrir\"." }, "make": { "title": "Make", "type": "string", "description": "Vehicle make as on standvirtual.com, e.g. \"Renault\", \"Peugeot\", \"BMW\", \"Mercedes-Benz\"." }, "model": { "title": "Model", "type": "string", "description": "Model of the chosen make as on standvirtual.com, e.g. \"Clio\", \"Série 3\", \"Classe A\". Needs \"Make\"." }, "priceMin": { "title": "Min price (EUR)", "minimum": 0, "type": "integer", "description": "Lowest price in euro." }, "priceMax": { "title": "Max price (EUR)", "minimum": 0, "type": "integer", "description": "Highest price in euro." }, "yearMin": { "title": "Year from", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Oldest first registration year, e.g. 2018." }, "yearMax": { "title": "Year to", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Newest first registration year." }, "mileageMin": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Lowest mileage in kilometres." }, "mileageMax": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Highest mileage in kilometres." }, "fuelType": { "title": "Fuel type", "type": "array", "description": "One or more fuel types (any of them matches).", "items": { "type": "string", "enum": [ "gaz", "diesel", "hibride-gaz", "hibride-diesel", "plugin-hybrid", "electric", "gpl", "gnc", "hidrogen" ], "enumTitles": [ "Petrol (gasolina)", "Diesel", "Hybrid petrol", "Hybrid diesel", "Plug-in hybrid", "Electric", "LPG (GPL)", "CNG (GNC)", "Hydrogen" ] } }, "bodyType": { "title": "Body type", "type": "array", "description": "One or more body types (any of them matches).", "items": { "type": "string", "enum": [ "suv", "combi", "sedan", "compact", "city-car", "mini", "minivan", "coupe", "cabrio" ], "enumTitles": [ "SUV / off-road", "Estate (carrinha)", "Sedan", "Compact (utilitário)", "City car (citadino)", "Mini (pequeno citadino)", "Minivan (monovolume)", "Coupe", "Convertible" ] } }, "gearbox": { "title": "Gearbox", "enum": [ "manual", "automatic" ], "type": "string", "description": "Manual or automatic transmission." }, "condition": { "title": "Condition", "enum": [ "used", "new" ], "type": "string", "description": "New or used vehicles." }, "sellerType": { "title": "Seller type", "enum": [ "private", "business" ], "type": "string", "description": "Private sellers or dealers (companies)." }, "region": { "title": "Region", "enum": [ "lisboa", "porto", "setubal", "braga", "aveiro", "santarem", "leiria", "faro", "coimbra", "viseu", "vila-real", "viana-do-castelo", "castelo-branco", "evora", "portalegre", "beja", "guarda", "braganca", "madeira", "sao-miguel", "terceira", "pico" ], "type": "string", "description": "Portuguese district (distrito) or island. For a city with a radius, paste a search URL instead." }, "sort": { "title": "Sort by", "enum": [ "newest", "relevance", "priceAsc", "priceDesc", "mileageAsc", "mileageDesc", "powerAsc", "powerDesc" ], "type": "string", "description": "Order of results for the filter search and for search URLs that do not set their own order. \"Newest first\" is the most reliable for large runs.", "default": "newest" }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to save across all searches. 0 = no limit (every result of the search, there is no page cap).", "default": 50 }, "includeDetails": { "title": "Include details (phone, VIN, description)", "type": "boolean", "description": "Also open every listing page to add the seller phone numbers, VIN, full description, all photos, equipment list and the seller address with GPS. Costs an extra detail event per listing and is slower.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The default Apify proxy works for Standvirtual.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }