{
"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": "9Mk6WxlE3G9RkTcKC"
},
"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": {
"urls": {
"title": "🔗 URLs",
"type": "array",
"description": "Paste one or more coches.net URLs to scrape directly.
Supported URL types:
• Listing URLs — e.g. https://www.coches.net/bmw-serie-3-320i-4p-gasolina-2009-en-madrid-70672809-covo.aspx → extracts that single listing's full details.
• Search URLs — e.g. https://www.coches.net/segunda-mano/?MakeIds[0]=7 → paginates through those search results.
When URLs are provided, the make/model/fuel filters below are ignored — the URL already encodes the search. maxPages and maxItems limits still apply to search URLs.",
"items": {
"type": "string"
}
},
"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
},
"enableCursor": {
"title": "Incremental mode (cursor)",
"type": "boolean",
"description": "Only return listings newer than the last run.
When enabled, the actor stores the highest listing ID seen after each run in a Named KV Store. On the next run, it skips all listings with an ID at or below that watermark — so you only pay for genuinely new results.
Not compatible with URL mode — use filter-based search for incremental ingestion.
First run: captures all available listings and sets the initial cursor.
Subsequent runs: only new listings since the previous run.",
"default": false
},
"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
}
}
}
}
}
}
}
}
}
}