{ "openapi": "3.0.1", "info": { "title": "coches.net Scraper: Spain Used Car Prices, Deals & Dealers", "description": "Scrape used cars from coches.net, Spain's largest car marketplace. Filter by make, model, price, year, km, province or radius, fuel, DGT label and price rating. Export price, market price, specs, equipment, dealer contact and photos.", "version": "0.1", "x-build-id": "leRt1JsgAFiHxglkg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~coches-net-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-coches-net-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/fayoussef~coches-net-scraper/runs": { "post": { "operationId": "runs-sync-fayoussef-coches-net-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/fayoussef~coches-net-scraper/run-sync": { "post": { "operationId": "run-sync-fayoussef-coches-net-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": { "start_urls": { "title": "Start URLs", "type": "array", "description": "Optional. Paste any coches.net search URL (set the filters on the site, then copy the address bar) or individual listing URLs. When this is filled, the search filters below are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "max_items": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many cars. Leave empty to scrape every match: searches above 10,000 cars are split into price bands automatically so nothing is cut off." }, "include_details": { "title": "Include full listing details", "type": "boolean", "description": "Open each listing page for colour, version, full description, equipment list, specs (CO2, consumption, dimensions), new-car price and dealer address. Turn off for a much faster run with search data only (price, km, year, fuel, location, seller, photos).", "default": true }, "conditions": { "title": "Condition", "uniqueItems": true, "type": "array", "description": "Leave empty for the site's default (used, km 0, demo and ex-company cars).", "items": { "type": "string", "enum": [ "used", "km0", "new", "demo", "ex_company" ], "enumTitles": [ "Used (ocasión)", "Km 0", "New", "Demo", "Ex-company (sustitución / gerencia)" ] } }, "makes": { "title": "Makes", "uniqueItems": true, "type": "array", "description": "One or more makes. Leave empty for all makes.", "items": { "type": "string", "enum": [ "212", "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", "MAHINDRA", "MAN", "MASERATI", "MAXUS", "MAYBACH", "MAZDA", "MCLAREN", "MEGA", "MELEX", "MERCEDES-BENZ", "MG", "M-HERO", "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" ] } }, "models": { "title": "Models", "type": "array", "description": "Model names as written on coches.net, e.g. 'Golf', 'Serie 3', 'Clase A', 'Q3'. Matched against the makes above; a make with no model listed means all its models.", "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search on the listing, e.g. 'quattro', 'AMG', 'techo panorámico'." }, "price_from": { "title": "Price from", "minimum": 0, "type": "integer", "description": "Minimum price." }, "price_to": { "title": "Price to", "minimum": 0, "type": "integer", "description": "Maximum price." }, "year_from": { "title": "Year from", "minimum": 1900, "type": "integer", "description": "Oldest registration year." }, "year_to": { "title": "Year to", "minimum": 1900, "type": "integer", "description": "Newest registration year." }, "mileage_from_km": { "title": "Mileage from", "minimum": 0, "type": "integer", "description": "Minimum mileage." }, "mileage_to_km": { "title": "Mileage to", "minimum": 0, "type": "integer", "description": "Maximum mileage." }, "provinces": { "title": "Provinces", "uniqueItems": true, "type": "array", "description": "One or more Spanish provinces. Leave empty for all of Spain.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50", "51", "52" ], "enumTitles": [ "Álava", "Albacete", "Alicante", "Almería", "Ávila", "Badajoz", "Baleares", "Barcelona", "Burgos", "Cáceres", "Cádiz", "Castellón", "Ciudad Real", "Córdoba", "A Coruña", "Cuenca", "Girona", "Granada", "Guadalajara", "Guipúzcoa", "Huelva", "Huesca", "Jaén", "León", "Lleida", "La Rioja", "Lugo", "Madrid", "Málaga", "Murcia", "Navarra", "Ourense", "Asturias", "Palencia", "Las Palmas", "Pontevedra", "Salamanca", "Santa Cruz de Tenerife", "Cantabria", "Segovia", "Sevilla", "Soria", "Tarragona", "Teruel", "Toledo", "Valencia", "Valladolid", "Vizcaya", "Zamora", "Zaragoza", "Ceuta", "Melilla" ] } }, "location": { "title": "Near city or postal code", "type": "string", "description": "A Spanish city or postal code, e.g. 'Madrid', 'Sevilla', '46001'. Combine with Search radius. Use either this or Provinces." }, "radius_km": { "title": "Search radius", "enum": [ "5", "10", "20", "30", "50", "75", "100", "150", "200", "300", "500" ], "type": "string", "description": "Distance around the city or postal code above.", "default": "30" }, "fuel_types": { "title": "Fuel type", "uniqueItems": true, "type": "array", "description": "Leave empty for all fuels.", "items": { "type": "string", "enum": [ "diesel", "petrol", "electric", "hybrid", "plug_in_hybrid", "lpg", "cng", "other" ], "enumTitles": [ "Diesel", "Petrol", "Electric", "Hybrid", "Plug-in hybrid", "LPG (GLP)", "CNG (GNC)", "Other" ] } }, "body_types": { "title": "Body type", "uniqueItems": true, "type": "array", "description": "Leave empty for all body types.", "items": { "type": "string", "enum": [ "sedan", "coupe", "convertible", "estate", "mpv", "suv", "pickup", "van" ], "enumTitles": [ "Sedan (berlina)", "Coupe", "Convertible", "Estate (familiar)", "MPV (monovolumen)", "SUV / 4x4", "Pickup", "Van (furgoneta)" ] } }, "transmission": { "title": "Transmission", "enum": [ "automatic", "manual" ], "type": "string", "description": "Leave empty for both." }, "drivetrains": { "title": "Drivetrain", "uniqueItems": true, "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "awd", "front", "rear" ], "enumTitles": [ "All-wheel drive", "Front-wheel drive", "Rear-wheel drive" ] } }, "environmental_labels": { "title": "DGT environmental label", "uniqueItems": true, "type": "array", "description": "Spain's DGT sticker, which decides access to low-emission zones.", "items": { "type": "string", "enum": [ "zero", "eco", "c", "b" ], "enumTitles": [ "0 (zero emissions)", "ECO", "C", "B" ] } }, "power_from_hp": { "title": "Power from", "minimum": 0, "type": "integer", "description": "Minimum engine power." }, "power_to_hp": { "title": "Power to", "minimum": 0, "type": "integer", "description": "Maximum engine power." }, "doors_from": { "title": "Doors from", "minimum": 0, "type": "integer", "description": "Minimum number of doors." }, "doors_to": { "title": "Doors to", "minimum": 0, "type": "integer", "description": "Maximum number of doors." }, "seats_from": { "title": "Seats from", "minimum": 0, "type": "integer", "description": "Minimum number of seats." }, "seats_to": { "title": "Seats to", "minimum": 0, "type": "integer", "description": "Maximum number of seats." }, "colors": { "title": "Colour", "uniqueItems": true, "type": "array", "description": "Leave empty for all colours.", "items": { "type": "string", "enum": [ "yellow", "blue", "beige", "white", "maroon", "grey", "brown", "orange", "black", "red", "pink", "green", "purple" ], "enumTitles": [ "Yellow", "Blue", "Beige", "White", "Maroon", "Grey", "Brown", "Orange", "Black", "Red", "Pink", "Green", "Purple" ] } }, "seller_type": { "title": "Seller type", "enum": [ "dealer", "private" ], "type": "string", "description": "Dealers only, private sellers only, or both." }, "price_ratings": { "title": "Price rating (deals)", "uniqueItems": true, "type": "array", "description": "coches.net rates every asking price against the market. Pick 'Great price' and 'Good price' to get only the deals.", "items": { "type": "string", "enum": [ "great", "good", "fair", "above", "high" ], "enumTitles": [ "Great price (súper precio)", "Good price (buen precio)", "Fair price (precio justo)", "Above market (precio elevado)", "High price (precio alto)" ] } }, "only_with_warranty": { "title": "Only with warranty", "type": "boolean", "description": "Only cars sold with a warranty.", "default": false }, "only_certified": { "title": "Only certified", "type": "boolean", "description": "Only cars with a coches.net certification.", "default": false }, "only_with_financing": { "title": "Only with financing", "type": "boolean", "description": "Only cars with a financing offer (monthly payment shown).", "default": false }, "only_online_reservation": { "title": "Only with online reservation", "type": "boolean", "description": "Only cars you can reserve online.", "default": false }, "only_peninsula": { "title": "Mainland Spain only", "type": "boolean", "description": "Leave out the Balearic and Canary Islands, Ceuta and Melilla.", "default": false }, "sort_by": { "title": "Sort results by", "enum": [ "relevance", "newest", "price_asc", "price_desc", "mileage_asc", "year_desc", "year_asc" ], "type": "string", "description": "Order of the results. With a Start URL, the URL's own order is kept unless you pick something other than Relevance.", "default": "relevance" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Listing pages are behind bot protection and need a Spanish residential proxy, which is the default. Leave as is unless you bring your own proxies." } } }, "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 } } } } } } } } } }