{ "openapi": "3.0.1", "info": { "title": "Coches.com Scraper", "description": "Scrape coches.com, a top Spanish car site: 87,000+ used, Km 0 and new cars. Price, financing, 40+ specs, DGT label, plate, dealer and phone. Add-on: coches.com market price estimate and deal rating, showroom address and GPS, equipment. 20+ filters.", "version": "1.0", "x-build-id": "fYBvzmGE0Be9Mx71l" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~coches-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-coches-com-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~coches-com-scraper/runs": { "post": { "operationId": "runs-sync-normdata-coches-com-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~coches-com-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-coches-com-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 listings. Leave empty for no limit (about 87,000 cars). The Apify Free plan is always capped at 10." }, "conditions": { "title": "Condition", "type": "array", "description": "Used, Km 0 (nearly new, registered by the dealer) or new. All when not set.", "items": { "type": "string", "enum": [ "3", "2", "1" ], "enumTitles": [ "Used", "Km 0", "New" ] } }, "makesModels": { "title": "Makes and models", "type": "array", "description": "One per line, as the site writes them: \"Seat Ibiza\", \"BMW Serie 1\", \"Mercedes Clase A\", \"Toyota\" (a make alone = all its models). Accents and capitals are optional. Each make with models is searched on its own and the Maximum is shared evenly.", "items": { "type": "string" } }, "versionWords": { "title": "Version words", "type": "string", "description": "Words in the version name, e.g. \"118d\", \"xDrive\", \"TSI Style\" or \"M Sport\" (matches versions that contain them, so \"118d\" also finds \"118dA M Sport\")." }, "priceFrom": { "title": "Price from (€)", "minimum": 0, "type": "integer", "description": "Lowest cash price in euros." }, "priceTo": { "title": "Price to (€)", "minimum": 0, "type": "integer", "description": "Highest cash price in euros." }, "monthlyPaymentFrom": { "title": "Monthly payment from (€)", "minimum": 0, "type": "integer", "description": "Lowest monthly payment of the dealer's financing offer. Only listings with a financing offer." }, "monthlyPaymentTo": { "title": "Monthly payment to (€)", "minimum": 0, "type": "integer", "description": "Highest monthly payment of the dealer's financing offer." }, "yearFrom": { "title": "Year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Oldest registration year, e.g. 2018." }, "yearTo": { "title": "Year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Newest registration year." }, "mileageFrom": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Lowest odometer reading." }, "mileageTo": { "title": "Mileage to (km)", "minimum": 0, "type": "integer", "description": "Highest odometer reading." }, "powerFrom": { "title": "Power from (CV)", "minimum": 0, "type": "integer", "description": "Lowest engine power in CV (metric horsepower)." }, "powerTo": { "title": "Power to (CV)", "minimum": 0, "type": "integer", "description": "Highest engine power in CV." }, "fuels": { "title": "Fuel", "type": "array", "description": "Any when not set.", "items": { "type": "string", "enum": [ "Diésel", "Gasolina", "Eléctrico", "Híbrido Gasolina", "Híbrido Enchufable Gasolina", "Híbrido Enchufable Diésel", "Micro Híbrido Gasolina", "Micro Híbrido Diésel", "GLP", "GNC" ], "enumTitles": [ "Diesel", "Petrol", "Electric", "Hybrid petrol", "Plug-in hybrid petrol", "Plug-in hybrid diesel", "Mild hybrid petrol", "Mild hybrid diesel", "LPG", "CNG" ] } }, "gearbox": { "title": "Gearbox", "enum": [ "any", "Manual", "Automática" ], "type": "string", "description": "Any when not set." }, "bodyTypes": { "title": "Body type", "type": "array", "description": "The site's body groups. Any when not set.", "items": { "type": "string", "enum": [ "Pequeño", "Mediano", "Grande", "Familiar", "Monovolume", "Todoterreno", "Deportivo", "Comercial" ], "enumTitles": [ "Small", "Medium", "Large", "Estate", "MPV", "SUV and 4x4", "Sports", "Van and commercial" ] } }, "drives": { "title": "Drive", "type": "array", "description": "Any when not set.", "items": { "type": "string", "enum": [ "Tracción delantera", "Tracción trasera", "Tracción total permanente", "Tracción total conectable", "Todo terreno tracción total permanente", "Todo terreno tracción total conectable" ], "enumTitles": [ "Front-wheel drive", "Rear-wheel drive", "All-wheel drive (permanent)", "All-wheel drive (selectable)", "Off-road 4x4 (permanent)", "Off-road 4x4 (selectable)" ] } }, "colors": { "title": "Colour", "type": "array", "description": "Any when not set.", "items": { "type": "string", "enum": [ "white", "black", "grey", "blue", "red", "green", "beige", "brown", "orange", "yellow", "other" ], "enumTitles": [ "White", "Black", "Grey", "Blue", "Red", "Green", "Beige", "Brown", "Orange", "Yellow", "Other" ] } }, "environmentalLabels": { "title": "Environmental label (DGT)", "type": "array", "description": "Spanish DGT sticker: 0, ECO, C, B or none. Any when not set.", "items": { "type": "string", "enum": [ "0", "ECO", "C", "B", "NONE" ], "enumTitles": [ "0 (zero emissions)", "ECO", "C", "B", "No label" ] } }, "seatsFrom": { "title": "Seats from", "minimum": 0, "type": "integer", "description": "Fewest seats." }, "seatsTo": { "title": "Seats to", "minimum": 0, "type": "integer", "description": "Most seats." }, "doors": { "title": "Doors", "type": "array", "description": "Any when not set.", "items": { "type": "string", "enum": [ "2", "3", "4", "5" ], "enumTitles": [ "2", "3", "4", "5" ] } }, "provinces": { "title": "Provinces", "type": "array", "description": "Where the car is. Any when not set.", "items": { "type": "string", "enum": [ "15", "01", "02", "03", "04", "33", "05", "06", "07", "08", "09", "10", "11", "39", "12", "51", "13", "14", "16", "17", "18", "19", "20", "21", "22", "23", "26", "35", "24", "25", "27", "28", "29", "52", "30", "31", "32", "34", "36", "37", "38", "40", "41", "42", "43", "44", "45", "46", "47", "48", "49", "50" ], "enumTitles": [ "A Coruña", "Álava", "Albacete", "Alicante", "Almería", "Asturias", "Ávila", "Badajoz", "Baleares", "Barcelona", "Burgos", "Cáceres", "Cádiz", "Cantabria", "Castellón", "Ceuta", "Ciudad Real", "Córdoba", "Cuenca", "Girona", "Granada", "Guadalajara", "Guipúzcoa", "Huelva", "Huesca", "Jaén", "La Rioja", "Las Palmas", "León", "Lleida", "Lugo", "Madrid", "Málaga", "Melilla", "Murcia", "Navarra", "Ourense", "Palencia", "Pontevedra", "Salamanca", "Santa Cruz de Tenerife", "Segovia", "Sevilla", "Soria", "Tarragona", "Teruel", "Toledo", "Valencia", "Valladolid", "Vizcaya", "Zamora", "Zaragoza" ] } }, "sellerType": { "title": "Seller", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers or private sellers. Both when not set." }, "financingOnly": { "title": "With a financing offer only", "type": "boolean", "description": "Only cars with the dealer's monthly payment offer." }, "buyOnlineOnly": { "title": "Buy online only", "type": "boolean", "description": "Only cars you can reserve and buy on coches.com." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest", "updated", "priceLow", "priceHigh", "mileageLow", "yearNew", "yearOld", "powerHigh", "makeAZ" ], "type": "string", "description": "Relevance (as the site shows them) when not set." }, "includeDetails": { "title": "Include details (market price, showroom address, equipment)", "type": "boolean", "description": "Off: every search field (price, specs, financing, dealer, phone, photos). On: plus the fields above." }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "Save only listings not saved by earlier runs of the same search." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Optional. Runs with the same name share the list of seen listings, even if the filters change. Leave empty to track each search on its own." }, "urls": { "title": "Coches.com links (filters ignored with links)", "type": "array", "description": "coches.com/coches-segunda-mano/...htm?id=..., coches.com/km0/...htm?id=..., coches.com/coches-segunda-mano/bmw-serie-1.htm, or listing ids.", "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 } } } } } } } } } }