{
  "openapi": "3.0.1",
  "info": {
    "title": "Coches.net Scraper — Spain Cars, EV Battery & Dealers",
    "description": "Coches.net scraper for Spain's car market. One row per car with battery kWh, WLTP range and consumption, charging times, equipment, every photo, the VIN where published, and the dealer block with address, coordinates, website and phone. Searches past the 9,990-car limit are split by price.",
    "version": "0.0",
    "x-build-id": "qwofXqpU5YGZz7sWE"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~coches-net-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-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/memo23~coches-net-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-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/memo23~coches-net-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-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": {
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "coches.net search or ad URLs. Search pages such as https://www.coches.net/electrico/segunda-mano/profesionales/ or https://www.coches.net/kia/ev3/segunda-mano/, and single ads such as https://www.coches.net/kia-ev3-earth-standard-range-5p-electrico-hibrido-2025-en-a-coruna-71904478-covo.aspx. Leave empty to use the filter fields below.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Car make as coches.net names it, for example KIA, BMW, TESLA, MERCEDES-BENZ. Used only when Start URLs is empty."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model within the make, for example EV3, iX, Model 3. Needs Make."
          },
          "fuelType": {
            "title": "Fuel type",
            "enum": [
              "electric",
              "plugInHybrid",
              "hybrid",
              "petrol",
              "diesel",
              "lpg",
              "cng"
            ],
            "type": "string",
            "description": "Leave unset for every fuel."
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "all",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Dealers only, private sellers only, or both.",
            "default": "all"
          },
          "priceFrom": {
            "title": "Price from (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest asking price in euros."
          },
          "priceTo": {
            "title": "Price to (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest asking price in euros."
          },
          "yearFrom": {
            "title": "Year from",
            "minimum": 1950,
            "type": "integer",
            "description": "Oldest year to include."
          },
          "yearTo": {
            "title": "Year to",
            "minimum": 1950,
            "type": "integer",
            "description": "Newest year to include."
          },
          "maxMileageKm": {
            "title": "Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest odometer reading to include."
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Most cars to return. Each car is one charged result, so set this on your first run. The electric dealer segment alone holds about 4,000 cars.",
            "default": 100
          },
          "includeDetails": {
            "title": "Read each ad in full",
            "type": "boolean",
            "description": "On: battery, range, consumption, charging, equipment, the dealer's address and coordinates, the chassis number where published. Off: only what the search list shows (price, mileage, year, photos, phone, dealer name).",
            "default": true
          },
          "enrichEmails": {
            "title": "Find dealer emails",
            "type": "boolean",
            "description": "Look up each dealer's email address on their own website. Charged only per address found, and a dealer is looked up once per run however many cars they list.",
            "default": false
          },
          "maxPages": {
            "title": "Max search pages",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many search pages (about 30 cars each). 0 reads the whole search.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "How many ads to read at once.",
            "default": 5
          },
          "failOnIncomplete": {
            "title": "Fail the run when cars are missing",
            "type": "boolean",
            "description": "End the run as FAILED when it delivers fewer cars than coches.net reported for the search, instead of returning a short dataset that looks complete. Runs that stop at Max results or Max search pages are never failed for this.",
            "default": true
          },
          "completenessTolerancePercent": {
            "title": "Completeness tolerance (percent)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "How far below the site's own count a run may land before it fails, as a percentage. The larger of this and the absolute tolerance applies.",
            "default": 1
          },
          "completenessToleranceAbsolute": {
            "title": "Completeness tolerance (cars)",
            "minimum": 0,
            "type": "integer",
            "description": "How many cars a run may miss before it fails. Covers ads published and withdrawn while the run is in flight.",
            "default": 25
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}