{
  "openapi": "3.0.1",
  "info": {
    "title": "mobile.de Scraper",
    "description": "Scrape car listings from mobile.de search URLs. Paste a filtered search link and export structured data: price, mileage, specs, VAT, image, and full vehicle details from each listing.",
    "version": "0.4",
    "x-build-id": "qwJm8veEe2fSWCNmO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dadhalfdev~mobile-de-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dadhalfdev-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/dadhalfdev~mobile-de-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dadhalfdev-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/dadhalfdev~mobile-de-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dadhalfdev-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": {
          "input_url": {
            "title": "Input URL",
            "type": "string",
            "description": "Paste a mobile.de search URL to use instead of the filters below — overrides all structured filters when set. Also best for precise make+model. Leave empty to use the filters below (better for AI agents)."
          },
          "make": {
            "title": "Make",
            "enum": [
              "",
              "Abarth",
              "AC",
              "Acura",
              "Aiways",
              "Aixam",
              "Alfa Romeo",
              "ALPINA",
              "Alpine",
              "Alvis",
              "Ariel",
              "Artega",
              "Asia Motors",
              "Aston Martin",
              "Audi",
              "Austin",
              "Austin Healey",
              "Auto Union",
              "BAIC",
              "Barkas",
              "BAW",
              "Bentley",
              "Bizzarrini",
              "BMW",
              "Borgward",
              "Bovensiepen",
              "Brilliance",
              "Bugatti",
              "Buick",
              "BYD",
              "Cadillac",
              "Casalini",
              "Caterham",
              "Cenntro",
              "Changan",
              "Chatenet",
              "Chevrolet",
              "Chrysler",
              "Citroën",
              "Cobra",
              "Corvette",
              "Cupra",
              "Dacia",
              "Daewoo",
              "Daihatsu",
              "Dallara",
              "Datsun",
              "Delahaye",
              "DeLorean",
              "DeTomaso",
              "DFM",
              "DFSK",
              "Dodge",
              "Donkervoort",
              "DS Automobiles",
              "e.GO",
              "Elaris",
              "Estrima",
              "Facel Vega",
              "Ferrari",
              "Fiat",
              "Fisker",
              "Ford",
              "Foton",
              "GAC Gonow",
              "Geely",
              "Gemballa",
              "Genesis",
              "GMC",
              "Grecav",
              "GWM",
              "Hamann",
              "Heinkel",
              "Holden",
              "Honda",
              "Hongqi",
              "Horch",
              "Hummer",
              "Hyundai",
              "INEOS",
              "Infiniti",
              "Invicta",
              "Isuzu",
              "Iveco",
              "JAC",
              "JAECOO",
              "Jaguar",
              "Jeep",
              "Jetour",
              "Jiayuan",
              "KGM",
              "Kia",
              "Koenigsegg",
              "KTM",
              "Lada",
              "Lamborghini",
              "Lancia",
              "Land Rover",
              "Landwind",
              "Leapmotor",
              "LEVC",
              "Lexus",
              "Ligier",
              "Lincoln",
              "Lotus",
              "Lucid",
              "Lynk&Co",
              "Mahindra",
              "MAN",
              "Maserati",
              "Maxus",
              "Maybach",
              "Mazda",
              "McLaren",
              "Mercedes-Benz",
              "Messerschmitt",
              "MG",
              "Microcar",
              "Microlino",
              "MINI",
              "Mitsubishi",
              "Morgan",
              "NIO",
              "Nissan",
              "NSU",
              "Oldsmobile",
              "OMODA",
              "Opel",
              "ORA",
              "Packard",
              "Pagani",
              "Peugeot",
              "Piaggio",
              "Plymouth",
              "Polestar",
              "Pontiac",
              "Porsche",
              "Proton",
              "Renault",
              "Riley",
              "Rimac",
              "Rolls-Royce",
              "Rover",
              "Ruf",
              "Saab",
              "Santana",
              "Seat",
              "Seres",
              "Silence",
              "Simca",
              "Skoda",
              "Smart",
              "speedART",
              "Spyker",
              "Ssangyong",
              "Studebaker",
              "Subaru",
              "Suzuki",
              "SWM",
              "Talbot",
              "Tata",
              "TECHART",
              "Tesla",
              "Togg",
              "Toyota",
              "Trabant",
              "Triumph",
              "TVR",
              "TYN-e",
              "Vincent",
              "VinFast",
              "Volkswagen",
              "Volvo",
              "Voyah",
              "Wartburg",
              "Westfield",
              "WEY",
              "Wiesmann",
              "XEV",
              "XPENG",
              "Zeekr",
              "Zhidou",
              "Andere"
            ],
            "type": "string",
            "description": "Car brand, matching mobile.de's own make list exactly (so every option resolves to a valid search filter). For a specific model, paste an input_url from the browser instead. Ignored when input_url is set.",
            "default": ""
          },
          "ms": {
            "title": "Raw make/model (advanced)",
            "type": "string",
            "description": "Optional advanced value copied from a mobile.de search URL for precise make+model. Overrides make when set. Ignored when input_url is set."
          },
          "price_min": {
            "title": "Min price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum price in euros. Ignored when input_url is set."
          },
          "price_max": {
            "title": "Max price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum price in euros. Ignored when input_url is set."
          },
          "mileage_min": {
            "title": "Min mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Minimum mileage in km. Ignored when input_url is set."
          },
          "mileage_max": {
            "title": "Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum mileage in km. Ignored when input_url is set."
          },
          "year_min": {
            "title": "Min year (first registration)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Minimum first-registration year. Ignored when input_url is set."
          },
          "year_max": {
            "title": "Max year (first registration)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Maximum first-registration year. Ignored when input_url is set."
          },
          "energy": {
            "title": "Fuel / energy",
            "enum": [
              "",
              "PETROL",
              "DIESEL",
              "ELECTRICITY",
              "HYBRID",
              "HYBRID_DIESEL",
              "CNG",
              "LPG",
              "HYDROGENIUM",
              "ETHANOL",
              "OTHER"
            ],
            "type": "string",
            "description": "Fuel type. Ignored when input_url is set.",
            "default": ""
          },
          "gearbox": {
            "title": "Gearbox",
            "enum": [
              "",
              "AUTOMATIC_GEAR",
              "MANUAL_GEAR",
              "SEMIAUTOMATIC_GEAR"
            ],
            "type": "string",
            "description": "Transmission. Ignored when input_url is set.",
            "default": ""
          },
          "power_min": {
            "title": "Minimum power (kW)",
            "type": "integer",
            "description": "Lowest engine power in kW. Leave empty, any, or all to skip. Ignored when input_url is set."
          },
          "power_max": {
            "title": "Maximum power (kW)",
            "type": "integer",
            "description": "Highest engine power in kW. Leave empty, any, or all to skip. Ignored when input_url is set."
          },
          "show_damaged": {
            "title": "Include damaged vehicles",
            "type": "boolean",
            "description": "When true, include listings marked as damaged. Leave unset to keep undamaged vehicles only. Ignored when input_url is set."
          },
          "sort_by": {
            "title": "Sort by",
            "enum": [
              "Most Relevant",
              "Lowest Price",
              "Highest Price",
              "Lowest KM",
              "Highest KM",
              "Newest",
              "Oldest"
            ],
            "type": "string",
            "description": "How to order the results.",
            "default": "Most Relevant"
          },
          "max_cars": {
            "title": "Maximum number of cars",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "How many vehicle listings to return (1–200).",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}