{ "openapi": "3.0.1", "info": { "title": "🚗 Coches.net Cars & Vehicle Listings Scraper — 💰 $1.50/1,000", "description": "Scrape Coches.net used cars & vehicle listings: prices, mileage, specs, sellers, locations, images and details. Spain car data for $1.50 per 1,000.", "version": "0.1", "x-build-id": "qvmoYZLbzH4HLb3xy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zapticx~coches-net-vehicle-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zapticx-coches-net-vehicle-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/zapticx~coches-net-vehicle-listings-scraper/runs": { "post": { "operationId": "runs-sync-zapticx-coches-net-vehicle-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/zapticx~coches-net-vehicle-listings-scraper/run-sync": { "post": { "operationId": "run-sync-zapticx-coches-net-vehicle-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": { "searchQuery": { "title": "Keyword search", "type": "string", "description": "Free-text keywords, like the Coches.net search box, e.g. \"BMW X5\" or \"xDrive30d\". Coches.net matches them anywhere in the listing text, including the seller's description, so results can include other models that mention the words. For exact make/model results use the Make and Model filters instead." }, "make": { "title": "Make", "enum": [ "ABARTH", "AIWAYS", "AIXAM", "ALFA ROMEO", "ALPINE", "ARO", "ASIA", "ASIA MOTORS", "ASTON MARTIN", "AUDI", "AUSTIN", "AUVERLAND", "BAIC", "BELLIER", "BENTLEY", "BERTONE", "BESTUNE", "BMW", "BUGATTI", "BUNKER-TRIKE", "BYD", "CADILLAC", "CASALINI", "CENNTRO", "CHANGAN", "CHATENET", "CHEVROLET", "CHRYSLER", "CITROEN", "CORVETTE", "CUPRA", "DACIA", "DAEWOO", "DAF", "DAIHATSU", "DAIMLER", "DENZA", "DFSK", "DODGE", "DONGFENG", "DR AUTOMOBILES", "DS", "DSK", "EBRO", "ERAD", "ESTRIMA BIRO", "EVO", "EVUM", "FARIZON", "FERRARI", "FIAT", "FISKER", "FORD", "FOTON", "FUSO", "GALLOPER", "GEELY", "GME", "GRECAV", "GREEN TOUR", "GWM", "HERKO", "HONDA", "HONGQI", "HUMMER", "HYUNDAI", "ICH-X", "INEOS", "INFINITI", "INNOCENTI", "ISUZU", "ITAL CAR", "IVECO", "IVECO-PEGASO", "JAECOO", "JAGUAR", "JDM", "JEEP", "KGM", "KIA", "KTM", "LADA", "LAMBORGHINI", "LANCIA", "LAND-ROVER", "LDV", "LEAPMOTOR", "LEPAS", "LEVC", "LEXUS", "LIGIER", "LIVAN", "LOTUS", "LYNK & CO", "M-HERO", "MAHINDRA", "MAN", "MASERATI", "MAXUS", "MAYBACH", "MAZDA", "MCLAREN", "MEGA", "MELEX", "MERCEDES-BENZ", "MG", "MICRO", "MICROCAR", "MINI", "MITSUBISHI", "MOBILIZE", "MORGAN", "MW MOTORS", "NEXTEM", "NISSAN", "OMODA", "OPEL", "PEUGEOT", "PGO SCOOTERS", "PIAGGIO", "POLARIS", "POLESTAR", "PONTIAC", "PORSCHE", "QOROS", "QUOVIS", "RAM", "RENAULT", "RENAULT V.I.", "ROLLS-ROYCE", "ROVER", "SAAB", "SAIC", "SANTANA", "SEAT", "SERES", "SHINERAY", "SILENCE", "SKODA", "SKYWELL", "SMART", "SPORTEQUIPE", "SSANGYONG", "SUBARU", "SUZUKI", "SWM", "TALBOT", "TASSO", "TATA", "TESLA", "TIGER", "TOYOTA", "TWIKE", "UMM", "VAZ", "VIDI", "VOLKSWAGEN", "VOLVO", "VOYAH", "WARTBURG", "XPENG", "YUDO", "ZEEKR", "ZEST", "ZHIDOU" ], "type": "string", "description": "Only vehicles of this make (brand), e.g. BMW, SEAT, Toyota, Mercedes-Benz." }, "model": { "title": "Model", "type": "string", "description": "Only this model of the selected make, written as Coches.net shows it, e.g. \"X5\", \"Serie 3\", \"León\", \"Clase C\". Requires Make. An unknown model stops the run with a list of valid examples instead of returning unrelated cars." }, "startUrls": { "title": "Coches.net URLs", "type": "array", "description": "Instead of filters, paste supported Coches.net search or listing URLs. Supported: used-car searches under /segunda-mano/ — by make or make+model (/bmw/x5/segunda-mano/), fuel (/electrico/segunda-mano/), body type, colour or DGT label, optionally followed by a province, /particulares/, /automaticos/ or /10000_euros/ (price cap); filtered /segunda-mano/?… URLs from the Coches.net search form; and individual listing URLs (…-12345678-covo.aspx). Each URL runs as its own search, in the order given, until Maximum vehicles is reached; duplicates across URLs are removed. Other Coches.net pages (regions, new cars, km 0, vans, themed pages) are skipped with an explanation. When URLs are given, the filters on this page (including the prefilled Make) are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Maximum vehicles", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of unique Coches.net vehicle listings to save, in total. With several Coches.net URLs they are processed in order until this total is reached. Duplicates are never counted or charged. If fewer vehicles match, the run saves all it can find.", "default": 100 }, "includeDetails": { "title": "Include listing details", "type": "boolean", "description": "Also read each listing's detail data: description, version, doors, seats, colour, CO₂ emissions, factory standard equipment and dealer home delivery. Same price per vehicle either way; turn off for faster search-only results.", "default": true }, "minPrice": { "title": "Minimum price (€)", "minimum": 0, "type": "integer", "description": "Only vehicles priced at or above this amount in euros." }, "maxPrice": { "title": "Maximum price (€)", "minimum": 0, "type": "integer", "description": "Only vehicles priced at or below this amount in euros." }, "minYear": { "title": "Registration year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only vehicles first registered in or after this year." }, "maxYear": { "title": "Registration year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Only vehicles first registered in or before this year." }, "minMileage": { "title": "Minimum mileage (km)", "minimum": 0, "type": "integer", "description": "Only vehicles with at least this many kilometres." }, "maxMileage": { "title": "Maximum mileage (km)", "minimum": 0, "type": "integer", "description": "Only vehicles with at most this many kilometres." }, "fuelTypes": { "title": "Fuel type", "type": "array", "description": "Only these fuel types (any of the selected). Coches.net names: Diésel, Gasolina, Eléctrico, Híbrido, Híbrido enchufable, Gas licuado (GLP), Gas natural (CNG).", "items": { "type": "string", "enum": [ "diesel", "petrol", "electric", "hybrid", "plug_in_hybrid", "lpg", "cng" ], "enumTitles": [ "Diesel (Diésel)", "Petrol (Gasolina)", "Electric (Eléctrico)", "Hybrid (Híbrido)", "Plug-in hybrid (Híbrido enchufable)", "LPG (Gas licuado (GLP))", "CNG (Gas natural (CNG))" ] } }, "transmission": { "title": "Transmission", "enum": [ "all", "automatic", "manual" ], "type": "string", "description": "Only automatic or only manual gearboxes.", "default": "all" }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Only these body types, using Coches.net's own body-type filter. Coches.net classifies some models by model family, so a result's own \"bodyType\" can occasionally differ (e.g. the Coupé filter also returns Mercedes CLA saloons).", "items": { "type": "string", "enum": [ "sedan_hatchback", "coupe", "convertible", "estate", "mpv", "suv", "pickup" ], "enumTitles": [ "Sedan / hatchback (Berlina)", "Coupe (Coupé)", "Convertible (Cabrio)", "Estate (Familiar)", "MPV / minivan (Monovolumen)", "SUV / off-road (SUV)", "Pick-up (Pick Up)" ] } }, "environmentalLabels": { "title": "DGT environmental label", "type": "array", "description": "Only vehicles with these Spanish DGT environmental stickers.", "items": { "type": "string", "enum": [ "zero", "eco", "c", "b" ], "enumTitles": [ "CERO (0 emissions)", "ECO", "C", "B" ] } }, "colors": { "title": "Colour", "type": "array", "description": "Only vehicles in these colours (as declared on Coches.net).", "items": { "type": "string", "enum": [ "yellow", "blue", "beige", "white", "maroon", "grey_silver", "brown", "orange", "black", "red", "pink", "green", "purple" ], "enumTitles": [ "Yellow", "Blue", "Beige", "White", "Maroon", "Grey / silver", "Brown", "Orange", "Black", "Red", "Pink", "Green", "Purple" ] } }, "provinces": { "title": "Province", "type": "array", "description": "Only vehicles Coches.net offers in these Spanish provinces. Dealers with branches in several provinces can appear under each of them; the output always shows the listing's own city and province.", "items": { "type": "string", "enum": [ "A Coruña", "Albacete", "Alicante", "Almería", "Asturias", "Badajoz", "Baleares", "Barcelona", "Burgos", "Cantabria", "Castellón", "Ceuta", "Ciudad Real", "Cuenca", "Cáceres", "Cádiz", "Córdoba", "Girona", "Granada", "Guadalajara", "Guipúzcoa", "Huelva", "Huesca", "Jaén", "La Rioja", "Las Palmas", "León", "Lleida", "Lugo", "Madrid", "Melilla", "Murcia", "Málaga", "Navarra", "Orense", "Palencia", "Pontevedra", "Salamanca", "Segovia", "Sevilla", "Soria", "Sta. C. Tenerife", "Tarragona", "Teruel", "Toledo", "Valencia", "Valladolid", "Vizcaya", "Zamora", "Zaragoza", "Álava", "Ávila" ] } }, "sellerType": { "title": "Seller type", "enum": [ "all", "private", "professional" ], "type": "string", "description": "Only private sellers or only professional dealers.", "default": "all" }, "sort": { "title": "Sort order", "enum": [ "relevance", "newest", "price_asc", "price_desc", "year_desc", "year_asc", "mileage_asc", "mileage_desc" ], "type": "string", "description": "Order in which Coches.net returns listings; with a Maximum below the number of matches this decides which vehicles you get.", "default": "relevance" }, "useDatacenterProxy": { "title": "Always use Apify datacenter proxy", "type": "boolean", "description": "Not needed normally: the Actor connects directly and switches to Apify datacenter proxy by itself only if Coches.net starts refusing requests. Turn on to use the proxy from the start. Same price per vehicle either way.", "default": false } } }, "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 } } } } } } } } } }