{
  "openapi": "3.0.1",
  "info": {
    "title": "mobile.de Scraper - Car Listings, Prices, Specs & Dealers",
    "description": "Scrape mobile.de car, motorbike and motorhome listings by make, model, price, year, mileage, fuel or search link: price, price rating, mileage, power, specs, equipment, description, photos and dealer details. onlyNew for daily alerts. Error rows are free.",
    "version": "0.1",
    "x-build-id": "20AN42mu2xyfARERB"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapewise~mobile-de-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapewise-mobile-de-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/scrapewise~mobile-de-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapewise-mobile-de-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/scrapewise~mobile-de-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapewise-mobile-de-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": {
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Brand as mobile.de shows it, for example BMW, Volkswagen, Mercedes-Benz or Tesla. Leave empty to search every make."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model or model series as the site shows it, for example 3 Series, 320, Golf or Model 3. Needs a make."
          },
          "query": {
            "title": "Keyword",
            "type": "string",
            "description": "Optional free text matched against the listing title, for example M Sport or Touring."
          },
          "vehicleType": {
            "title": "Vehicle type",
            "enum": [
              "Car",
              "Motorbike",
              "Motorhome"
            ],
            "type": "string",
            "description": "Which part of mobile.de to search.",
            "default": "Car"
          },
          "minPrice": {
            "title": "Price from (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest gross price in euros."
          },
          "maxPrice": {
            "title": "Price to (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest gross price in euros."
          },
          "minYear": {
            "title": "First registration from (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest first registration year, for example 2019."
          },
          "maxYear": {
            "title": "First registration to (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest first registration year."
          },
          "maxMileage": {
            "title": "Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest mileage in kilometres, for example 100000."
          },
          "fuelTypes": {
            "title": "Fuel",
            "type": "array",
            "description": "Keep only these fuel types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "PETROL",
                "DIESEL",
                "ELECTRICITY",
                "HYBRID",
                "HYBRID_DIESEL",
                "LPG",
                "CNG",
                "HYDROGENIUM",
                "ETHANOL",
                "OTHER"
              ],
              "enumTitles": [
                "Petrol",
                "Diesel",
                "Electric",
                "Hybrid (petrol/electric)",
                "Hybrid (diesel/electric)",
                "LPG",
                "CNG",
                "Hydrogen",
                "Ethanol",
                "Other"
              ]
            }
          },
          "transmission": {
            "title": "Gearbox",
            "type": "array",
            "description": "Keep only these gearbox types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "AUTOMATIC_GEAR",
                "MANUAL_GEAR",
                "SEMIAUTOMATIC_GEAR"
              ],
              "enumTitles": [
                "Automatic",
                "Manual",
                "Semi-automatic"
              ]
            }
          },
          "bodyTypes": {
            "title": "Body type (cars)",
            "type": "array",
            "description": "Keep only these body types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Cabrio",
                "EstateCar",
                "Limousine",
                "SmallCar",
                "SportsCar",
                "OffRoad",
                "Van",
                "OtherCar"
              ],
              "enumTitles": [
                "Convertible",
                "Estate",
                "Saloon",
                "Small car",
                "Sports car / coupe",
                "SUV / off-road / pickup",
                "Van / minibus",
                "Other"
              ]
            }
          },
          "countryCode": {
            "title": "Vehicle country",
            "type": "string",
            "description": "Two-letter country code of the vehicle location, for example DE, AT, NL or IT. Empty = every country listed on mobile.de."
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Empty = both."
          },
          "excludeDamaged": {
            "title": "Hide damaged vehicles",
            "type": "boolean",
            "description": "On (like the site default): leaves out accident-damaged and not roadworthy vehicles.",
            "default": true
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "price_asc",
              "price_desc",
              "mileage_asc",
              "registration_desc"
            ],
            "type": "string",
            "description": "Order of the results. onlyNew switches the site default to newest first.",
            "default": "relevance"
          },
          "startUrls": {
            "title": "mobile.de links",
            "type": "array",
            "description": "Optional: search links copied from the address bar of mobile.de after setting filters on the site (every filter in the link is used), or listing links. They run in addition to the fields above.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Full listing details",
            "type": "boolean",
            "description": "On: opens each listing for the description, full equipment list, technical data and dealer opening hours and scores. Off: faster, the row keeps price, specs, photos and dealer name and address.",
            "default": true
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap for the whole run, across all searches. 0 = no cap. mobile.de shows at most 2,000 listings per search.",
            "default": 50
          },
          "onlyNew": {
            "title": "Only new listings (for schedules)",
            "type": "boolean",
            "description": "On: remembers the listings delivered in earlier runs of the same search (in your account) and delivers only listings not seen before. Skipped listings are free.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Apify datacenter proxy by default; if mobile.de refuses it, the run moves to a stronger proxy group on its own. Change it only if you know you need to.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}