{ "openapi": "3.0.1", "info": { "title": "OcasionPlus Scraper - Spain Used Cars & Motorbikes", "description": "Scrape used cars and motorbikes from OcasionPlus, a top Spanish dealer network. Get prices, financing, km, year, specs, dealer and photos, plus VIN, extras, full equipment, ITV and service history. Filter by brand, price, km, fuel, body, label and province. 1,000 cars in 3 seconds.", "version": "1.0", "x-build-id": "vsSwIAGjmug8xa1Gc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~ocasionplus-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-ocasionplus-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/normdata~ocasionplus-scraper/runs": { "post": { "operationId": "runs-sync-normdata-ocasionplus-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/normdata~ocasionplus-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-ocasionplus-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many cars in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "vehicleType": { "title": "Vehicles", "enum": [ "cars", "motorbikes", "all" ], "type": "string", "description": "Cars, motorbikes or both. Empty = cars." }, "sortBy": { "title": "Sort by", "enum": [ "morePopular", "lastPublished", "lowerPrice", "higherPrice", "lowerQuote", "higherQuote", "lowerKm", "higherKm", "higherYear", "lowerPublished", "higherPower" ], "type": "string", "description": "The order the site lists them in. Empty = most relevant." }, "brands": { "title": "Brands", "type": "array", "description": "Only these brands, like \"Toyota\", \"Volkswagen\" or \"Mercedes\". Empty = every brand.", "items": { "type": "string" } }, "models": { "title": "Models", "type": "array", "description": "Only these models, like \"Golf\", \"Serie 3\" or \"Toyota C-HR\", in the site's own names. Empty = every model.", "items": { "type": "string" } }, "locations": { "title": "Provinces, cities or dealers", "type": "array", "description": "Only cars at dealers in these places, like \"Madrid\", \"Barcelona\", \"Las Palmas\" or \"Getafe\". Empty = all of Spain.", "items": { "type": "string" } }, "includeDetails": { "title": "Car details (VIN, extras, equipment, specs, dealer contacts)", "type": "boolean", "description": "Also read each car page for the VIN, version, color, doors, seats, gears, engine size, consumption, CO2, range, size, weight, trunk, top speed, extras, full equipment, ITV date, last service, every photo, the inspection report, 360 view, and the dealer phone, email, map position and hours. Charged per car as an add-on." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Cash price, as shown on the site." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Cash price, as shown on the site." }, "maxMonthlyPayment": { "title": "Maximum monthly payment (EUR)", "minimum": 0, "type": "integer", "description": "Keep only cars the site finances for at most this much a month." }, "minYear": { "title": "From year", "minimum": 0, "type": "integer", "description": "First registration year, like 2018." }, "maxYear": { "title": "To year", "minimum": 0, "type": "integer", "description": "First registration year, like 2023." }, "minKm": { "title": "Minimum km", "minimum": 0, "type": "integer", "description": "Kilometers driven." }, "maxKm": { "title": "Maximum km", "minimum": 0, "type": "integer", "description": "Kilometers driven, like 100000." }, "minHorsepower": { "title": "Minimum horsepower (CV)", "minimum": 0, "type": "integer", "description": "Engine power in CV." }, "maxHorsepower": { "title": "Maximum horsepower (CV)", "minimum": 0, "type": "integer", "description": "Engine power in CV." }, "fuels": { "title": "Fuel", "type": "array", "description": "Keep only these fuels.", "items": { "type": "string", "enum": [ "Petrol", "Diesel", "Hybrid", "Plug-in hybrid", "Electric", "LPG", "CNG" ], "enumTitles": [ "Petrol", "Diesel", "Hybrid", "Plug-in hybrid", "Electric", "LPG", "CNG" ] } }, "powertrains": { "title": "Powertrain", "type": "array", "description": "Keep only these engine types.", "items": { "type": "string", "enum": [ "Combustion", "Mild hybrid", "Full hybrid", "Plug-in hybrid", "Electric" ], "enumTitles": [ "Combustion", "Mild hybrid", "Full hybrid", "Plug-in hybrid", "Electric" ] } }, "transmissions": { "title": "Gearbox", "type": "array", "description": "Keep only these gearboxes.", "items": { "type": "string", "enum": [ "Manual", "Automatic" ], "enumTitles": [ "Manual", "Automatic" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Keep only these body types (the last ones are for motorbikes).", "items": { "type": "string", "enum": [ "Sedan", "SUV", "Hatchback", "Estate", "MPV", "Coupe", "Convertible", "Van", "Pickup", "Camper", "Trail", "Naked", "Touring", "Scooter", "Scooter over 125 cc", "Custom", "Sport", "Three-wheeler", "Quad" ], "enumTitles": [ "Sedan", "SUV", "Hatchback", "Estate", "MPV", "Coupe", "Convertible", "Van", "Pickup", "Camper", "Trail", "Naked", "Touring", "Scooter", "Scooter over 125 cc", "Custom", "Sport", "Three-wheeler", "Quad" ] } }, "environmentalLabels": { "title": "DGT environmental label", "type": "array", "description": "Keep only cars with these Spanish DGT labels.", "items": { "type": "string", "enum": [ "0", "ECO", "C", "B" ], "enumTitles": [ "0 emissions", "ECO", "C", "B" ] } }, "conditions": { "title": "Condition", "type": "array", "description": "Keep only used, Km 0 or new vehicles.", "items": { "type": "string", "enum": [ "Used", "Km 0", "New" ], "enumTitles": [ "Used", "Km 0", "New" ] } }, "listedSince": { "title": "Listed since", "type": "string", "description": "Keep only cars put on sale on or after this date, like 2026-10-01 or \"7 days\"." }, "onlyAvailable": { "title": "Only available", "type": "boolean", "description": "Leave out cars already reserved by a buyer." }, "onlySingleOwner": { "title": "Only single owner", "type": "boolean", "description": "Keep only cars the site marks as having had one owner." }, "onlyWithOfficialWarranty": { "title": "Only with official warranty", "type": "boolean", "description": "Keep only cars still under the maker's warranty." }, "onlyVatDeductible": { "title": "Only VAT deductible", "type": "boolean", "description": "Keep only cars sold with deductible VAT (for companies and the self-employed)." }, "onlyDiscounted": { "title": "Only discounted", "type": "boolean", "description": "Keep only cars with a discount on the price." }, "onlyPriceDropped": { "title": "Only with a price drop", "type": "boolean", "description": "Keep only cars whose price has been lowered." }, "onlyDelivery48h": { "title": "Only 48-hour delivery", "type": "boolean", "description": "Keep only cars the site delivers in 48 hours." }, "colors": { "title": "Color", "type": "array", "description": "Keep only these colors. Turns on car details.", "items": { "type": "string", "enum": [ "White", "Black", "Grey", "Dark grey", "Silver", "Blue", "Red", "Green", "Brown", "Beige", "Gold", "Orange", "Pink", "Yellow", "Purple", "Maroon", "Bronze" ], "enumTitles": [ "White", "Black", "Grey", "Dark grey", "Silver", "Blue", "Red", "Green", "Brown", "Beige", "Gold", "Orange", "Pink", "Yellow", "Purple", "Maroon", "Bronze" ] } }, "minSeats": { "title": "Minimum seats", "minimum": 0, "type": "integer", "description": "Like 7 for a 7-seater. Turns on car details." }, "onlyFourWheelDrive": { "title": "Only 4x4", "type": "boolean", "description": "Keep only four-wheel drive cars. Turns on car details." }, "onlyWithCarfax": { "title": "Only with Carfax report", "type": "boolean", "description": "Keep only cars with a Carfax history report. Turns on car details." }, "onlyWithServiceBook": { "title": "Only with service book", "type": "boolean", "description": "Keep only cars with a photo of their service book. Turns on car details." }, "onlyNew": { "title": "Only new cars", "type": "boolean", "description": "Skip cars saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Car or motorbike pages (https://www.ocasionplus.com/coches-segunda-mano/audi-a1-...-con-99837km-2019-ztobjqaz) or listings by path, like https://www.ocasionplus.com/coches-segunda-mano/audi/a1 or https://www.ocasionplus.com/coches-segunda-mano/madrid.", "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 } } } } } } } } } }