{ "openapi": "3.0.1", "info": { "title": "Coches.net Scraper", "description": "Scrape Coches.net car listings from any filtered search URL. Extract prices, specs, mileage, year, location, seller details, phone visibility, financing, warranty, ratings, and price-drop data. Sort results and export structured datasets.", "version": "0.1", "x-build-id": "j41itsnsHskFAwu94" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dadhalfdev~coches-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dadhalfdev-coches-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~coches-scraper/runs": { "post": { "operationId": "runs-sync-dadhalfdev-coches-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~coches-scraper/run-sync": { "post": { "operationId": "run-sync-dadhalfdev-coches-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 Coches.net search results URL (e.g. https://www.coches.net/bmw/serie-3/segunda-mano/) 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", "AIWAYS", "AIXAM", "ALFA ROMEO", "ALPINE", "ARO", "ASIA", "ASIA MOTORS", "ASTON MARTIN", "AUDI", "AUSTIN", "AUVERLAND", "BAIC", "BENTLEY", "BERTONE", "BESTUNE", "BMW", "BYD", "CADILLAC", "CHANGAN", "CHEVROLET", "CHRYSLER", "CITROEN", "CORVETTE", "CUPRA", "DACIA", "DAEWOO", "DAIHATSU", "DAIMLER", "DENZA", "DFSK", "DODGE", "DONGFENG", "DR AUTOMOBILES", "DS", "EBRO", "EVO", "FERRARI", "FIAT", "FORD", "FOTON", "GALLOPER", "GEELY", "HONDA", "HUMMER", "HYUNDAI", "ICH-X", "INEOS", "INFINITI", "ISUZU", "IVECO", "IVECO-PEGASO", "JAECOO", "JAGUAR", "JEEP", "KGM", "KIA", "LADA", "LAMBORGHINI", "LANCIA", "LAND-ROVER", "LEAPMOTOR", "LEXUS", "LIGIER", "LIVAN", "LOTUS", "LYNK & CO", "MAHINDRA", "MASERATI", "MAXUS", "MAYBACH", "MAZDA", "MCLAREN", "MERCEDES-BENZ", "MG", "MICRO", "MINI", "MITSUBISHI", "MOBILIZE", "MORGAN", "NISSAN", "OMODA", "OPEL", "PEUGEOT", "PIAGGIO", "POLESTAR", "PONTIAC", "PORSCHE", "RAM", "RENAULT", "RENAULT V.I.", "ROLLS-ROYCE", "ROVER", "SAAB", "SANTANA", "SEAT", "SERES", "SILENCE", "SKODA", "SMART", "SPORTEQUIPE", "SSANGYONG", "SUBARU", "SUZUKI", "SWM", "TALBOT", "TATA", "TESLA", "TIGER", "TOYOTA", "UMM", "VOLKSWAGEN", "VOLVO", "VOYAH", "WARTBURG", "XPENG", "YUDO", "ZEEKR", "ZHIDOU" ], "type": "string", "description": "Car brand, matching Coches.net's own make list exactly (119 brands with active listings). Leave empty to search all brands. Ignored when input_url is set.", "default": "" }, "model": { "title": "Model", "type": "string", "description": "Optional model (e.g. Golf, Leon, Serie 3). Best used together with make. Ignored when input_url is set." }, "province": { "title": "Province", "enum": [ "", "Araba", "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", "Gipuzkoa", "Huelva", "Huesca", "Jaén", "León", "Lleida", "La Rioja", "Lugo", "Madrid", "Málaga", "Murcia", "Navarra", "Ourense", "Asturias", "Palencia", "Las Palmas", "Pontevedra", "Salamanca", "Sta. C. Tenerife", "Cantabria", "Segovia", "Sevilla", "Soria", "Tarragona", "Teruel", "Toledo", "Valencia", "Valladolid", "Bizkaia", "Zamora", "Zaragoza", "Ceuta", "Melilla" ], "type": "string", "description": "Spanish province (all 52). Empty = nationwide. Ignored when input_url is set.", "default": "" }, "body_type": { "title": "Body type", "enum": [ "", "Berlina", "Coupé", "Cabrio", "Familiar", "Monovolumen", "SUV", "Pick Up", "Furgoneta" ], "type": "string", "description": "Vehicle body style. Ignored when input_url is set.", "default": "" }, "price_min": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum cash price in euros. Ignored when input_url is set." }, "price_max": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum cash 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 first-registration year. Ignored when input_url is set." }, "year_max": { "title": "Max year", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Maximum first-registration year. Ignored when input_url is set." }, "energy": { "title": "Fuel / energy", "enum": [ "", "Diésel", "Gasolina", "Eléctrico", "Híbrido", "Híbrido enchufable", "Gas licuado (GLP)", "Gas natural (CNG)", "Otros" ], "type": "string", "description": "Fuel type. Ignored when input_url is set.", "default": "" }, "gearbox": { "title": "Gearbox", "enum": [ "", "Automático", "Manual" ], "type": "string", "description": "Transmission type. Ignored when input_url is set.", "default": "" }, "filter_by": { "title": "Sort by", "enum": [ "Most Relevant", "Lowest Price", "Highest Price", "Lowest Monthly Fee", "Highest Monthly Fee", "Lowest KM", "Highest KM", "Oldest", "Newest" ], "type": "string", "description": "How to order the listings.", "default": "Most Relevant" }, "max_cars": { "title": "Max Cars", "minimum": 20, "maximum": 1500, "type": "integer", "description": "The maximum number of cars to scrape (20–1500).", "default": 500 } } }, "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 } } } } } } } } } }