{ "openapi": "3.0.1", "info": { "title": "Coches.net Scraper — Spain Car Listings", "description": "Scrape vehicle listings from Coches.net, Spain's leading car marketplace. Get price, brand, model, year, mileage, fuel type, dealer info, specs, and photos. Filter by any parameter. Perfect for automotive market analysis, price monitoring, and dealer intelligence in Spain.", "version": "0.1", "x-build-id": "dGBLWlRXDcsBB6ULU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rastriq~cochesnet-spain/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rastriq-cochesnet-spain", "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/rastriq~cochesnet-spain/runs": { "post": { "operationId": "runs-sync-rastriq-cochesnet-spain", "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/rastriq~cochesnet-spain/run-sync": { "post": { "operationId": "run-sync-rastriq-cochesnet-spain", "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": { "make": { "title": "Make (brand)", "type": "string", "description": "Car brand. Type the name exactly as it appears on coches.net (e.g. \"Alfa Romeo\", \"BMW\", \"Mercedes-Benz\"). You can also pass the numeric coches.net make ID directly." }, "model": { "title": "Model", "type": "string", "description": "Car model within the selected make. Examples: \"Spider\", \"Serie 3\", \"Clase A\". Requires make to be set. Leave blank to get all models of that brand." }, "fuel": { "title": "Fuel type", "enum": [ "gasolina", "diesel", "electrico", "hibrido", "glp" ], "type": "string", "description": "Filter by fuel type. Leave unset to include all fuel types." }, "minPrice": { "title": "Min price (€)", "type": "integer", "description": "Only return listings priced at or above this amount (in EUR)." }, "maxPrice": { "title": "Max price (€)", "type": "integer", "description": "Only return listings priced at or below this amount (in EUR)." }, "minYear": { "title": "Min year", "minimum": 1950, "maximum": 2027, "type": "integer", "description": "Only return vehicles registered in this year or later." }, "maxYear": { "title": "Max year", "minimum": 1950, "maximum": 2027, "type": "integer", "description": "Only return vehicles registered in this year or earlier." }, "maxPages": { "title": "Max pages", "type": "integer", "description": "Maximum search-result pages to crawl. Each page has ~30 listings. Set higher (e.g. 100) for full-market extractions.", "default": 3 }, "maxItems": { "title": "Max items", "type": "integer", "description": "Hard cap on total listings returned. The run stops as soon as it hits this number. Set to 9999 for effectively unlimited.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy or custom proxy URL. Recommended for runs over 500 listings to avoid throttling." } } }, "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 } } } } } } } } } }