{
  "openapi": "3.0.1",
  "info": {
    "title": "Mobile.de Cars Scraper",
    "description": "Mobile.de Cars Scraper SD - Mobile.de Cars Scraper is a logged-out tool that extracts car listings from mobile.de searches and listing links: price, price rating, mileage, first registration, power, fuel, equipment, description, images, finance offer, dealer details and dealer reviews.",
    "version": "1.0",
    "x-build-id": "lttTojhPTy1eRd3uF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/neuro-scraper~mobile-de-cars-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-neuro-scraper-mobile-de-cars-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/neuro-scraper~mobile-de-cars-scraper/runs": {
      "post": {
        "operationId": "runs-sync-neuro-scraper-mobile-de-cars-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/neuro-scraper~mobile-de-cars-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-neuro-scraper-mobile-de-cars-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": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "Free-text car searches, one per line, as typed into mobile.de's search box (mobile.de's full-text search: it matches the words in titles and descriptions - for an exact make and model use Models). Every result page is read until Max items. The filters below apply to every search term. Example: Volkswagen Golf GTI",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Search or listing URLs",
            "type": "array",
            "description": "mobile.de links: a search results page copied from the address bar (https://suchen.mobile.de/fahrzeuge/search.html?...&ms=3500%3B%3B%3B&vc=Car - its own filters are used) or a single listing (https://suchen.mobile.de/auto-inserat/.../<id>.html or .../details.html?id=<id>).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Optional make name as mobile.de lists it (looked up in mobile.de's own make list on every run). Searches this make; with Models below it is the default make of model names given without one. Example: Volkswagen",
            "default": ""
          },
          "models": {
            "title": "Models",
            "type": "array",
            "description": "Optional 'Make/Model' lines (model or model series, as named on mobile.de; looked up in mobile.de's own model list). Several lines = any of them. Examples: Mercedes-Benz/SLR, BMW/3 Series, Volkswagen/Golf",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "standard",
              "price_asc",
              "price_desc",
              "mileage_asc",
              "mileage_desc",
              "firstreg_asc",
              "firstreg_desc",
              "newest"
            ],
            "type": "string",
            "description": "mobile.de's own result order.",
            "default": "standard"
          },
          "fuelType": {
            "title": "Fuel type",
            "type": "array",
            "description": "Only these fuels (any of them). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "PETROL",
                "DIESEL",
                "ELECTRICITY",
                "HYBRID",
                "HYBRID_DIESEL",
                "LPG",
                "CNG",
                "HYDROGENIUM",
                "ETHANOL",
                "OTHER"
              ],
              "enumTitles": [
                "Petrol",
                "Diesel",
                "Electric",
                "Hybrid (petrol)",
                "Hybrid (diesel)",
                "LPG",
                "Natural gas (CNG)",
                "Hydrogen",
                "Ethanol",
                "Other"
              ]
            },
            "default": []
          },
          "transmission": {
            "title": "Transmission",
            "type": "array",
            "description": "Only these gearboxes (any of them). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "MANUAL_GEAR",
                "AUTOMATIC_GEAR",
                "SEMIAUTOMATIC_GEAR"
              ],
              "enumTitles": [
                "Manual",
                "Automatic",
                "Semi-automatic"
              ]
            },
            "default": []
          },
          "vehicleType": {
            "title": "Vehicle type (body)",
            "type": "array",
            "description": "Only these body types (any of them). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Cabrio",
                "EstateCar",
                "OffRoad",
                "Limousine",
                "SmallCar",
                "SportsCar",
                "Van",
                "OtherCar"
              ],
              "enumTitles": [
                "Cabriolet / Roadster",
                "Estate car",
                "SUV / Off-road / Pickup",
                "Saloon",
                "Small car",
                "Sports car / Coupe",
                "Van / Minibus",
                "Other"
              ]
            },
            "default": []
          },
          "exteriorColor": {
            "title": "Exterior colour",
            "type": "array",
            "description": "Only these colours (any of them). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "BLACK",
                "BEIGE",
                "GREY",
                "BROWN",
                "WHITE",
                "ORANGE",
                "BLUE",
                "YELLOW",
                "RED",
                "GREEN",
                "SILVER",
                "GOLD",
                "PURPLE"
              ],
              "enumTitles": [
                "Black",
                "Beige",
                "Grey",
                "Brown",
                "White",
                "Orange",
                "Blue",
                "Yellow",
                "Red",
                "Green",
                "Silver",
                "Gold",
                "Purple"
              ]
            },
            "default": []
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "ANY",
              "NEW",
              "USED"
            ],
            "type": "string",
            "description": "New or used vehicles only.",
            "default": "ANY"
          },
          "showDamagedVehicles": {
            "title": "Damaged vehicles",
            "enum": [
              "Any",
              "false",
              "true"
            ],
            "type": "string",
            "description": "Include, exclude or show only vehicles with unrepaired damage.",
            "default": "Any"
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "ANY",
              "DEALER",
              "PRIVATE"
            ],
            "type": "string",
            "description": "Dealers or private sellers only.",
            "default": "ANY"
          },
          "vatStatus": {
            "title": "VAT",
            "enum": [
              "ANY",
              "DEDUCTIBLE"
            ],
            "type": "string",
            "description": "Only listings with deductible VAT (MwSt. ausweisbar).",
            "default": "ANY"
          },
          "sellerId": {
            "title": "Dealer ID",
            "type": "string",
            "description": "Only cars of this seller - mobile.de's seller number (the sellerId column of any of its cars). Alone it lists the dealer's whole stock. Example: 12754808",
            "default": ""
          },
          "priceMin": {
            "title": "Price min (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in EUR. Empty = no minimum. Example: 5000"
          },
          "priceMax": {
            "title": "Price max (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in EUR. Empty = no maximum. Example: 30000"
          },
          "registrationDateYearMin": {
            "title": "First registration from (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest first-registration year. Example: 2018"
          },
          "registrationDateYearMax": {
            "title": "First registration to (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest first-registration year. Example: 2022"
          },
          "mileageKmMin": {
            "title": "Mileage min (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest mileage in km. Example: 10000"
          },
          "mileageKmMax": {
            "title": "Mileage max (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest mileage in km. Example: 100000"
          },
          "powerKwMin": {
            "title": "Power min (kW)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest engine power in kW (1 kW = 1.36 PS). Example: 100"
          },
          "powerKwMax": {
            "title": "Power max (kW)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest engine power in kW. Example: 250"
          },
          "location": {
            "title": "Country",
            "enum": [
              "Any",
              "DE",
              "AT",
              "BE",
              "CH",
              "CZ",
              "DK",
              "ES",
              "FR",
              "HR",
              "HU",
              "IT",
              "LU",
              "NL",
              "PL",
              "PT",
              "RO",
              "SE",
              "SI",
              "SK"
            ],
            "type": "string",
            "description": "Only vehicles located in this country (mobile.de also lists cars from neighbouring countries).",
            "default": "Any"
          },
          "latLong": {
            "title": "Around location (lat,lon)",
            "type": "string",
            "description": "Optional centre point for a radius search, as latitude,longitude. Used with Radius. Example: 52.52,13.405 (Berlin)",
            "default": ""
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Radius around the centre point in km (mobile.de's own radius filter). Example: 50"
          },
          "customFilters": {
            "title": "Custom filters",
            "type": "array",
            "description": "Advanced: extra mobile.de search parameters as name=value, one per line, added to every search (the names used in mobile.de search URLs). Examples: ecol=RED, ft=LPG, c=Van",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeKeywords": {
            "title": "Include keywords",
            "type": "array",
            "description": "Keep only cars whose title contains at least one of these words (checked by this Actor, case-insensitive). Example: competition",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop cars whose title contains any of these words (checked by this Actor, case-insensitive). Examples: unfall, export, defekt",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxAgeMinutes": {
            "title": "Max listing age (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only listings created within this many minutes (checked by this Actor on mobile.de's creation time). With sort 'Newest listings first' the search stops at the first page with only older listings. 0 = no limit. Example: 1440 (last 24 hours)",
            "default": 0
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut the plain-text description to this many characters (the HTML description is kept whole). 0 = no limit. Example: 500",
            "default": 0
          },
          "monitoringMode": {
            "title": "Monitoring mode",
            "type": "boolean",
            "description": "Compare with earlier runs of the same State key: every car gets changeType NEW / PRICE_CHANGED (with previousPrice and priceChange) and firstSeenAt; unchanged cars are skipped (and not charged) unless 'Emit unchanged' is on. Use with an Apify schedule.",
            "default": false
          },
          "emitUnchanged": {
            "title": "Emit unchanged cars",
            "type": "boolean",
            "description": "With monitoring mode: also output cars that are unchanged since the last run (changeType UNCHANGED).",
            "default": false
          },
          "stateKey": {
            "title": "State key",
            "type": "string",
            "description": "Name of the saved monitoring state (a named key-value store mobile-de-monitor-<name> in your account). One name per watched search. Example: golf-gti-berlin",
            "default": "default"
          },
          "maxItems": {
            "title": "Max items per search",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Maximum number of cars per search term, search URL or filter search. Result pages are read one after another until this number or the end of the results. mobile.de serves at most 2,000 results per search - turn on 'Get more results' to go further. Example: 100",
            "default": 20
          },
          "automaticPaging": {
            "title": "Enable automatic paging",
            "type": "boolean",
            "description": "Read result page after result page. Off = only the first result page of each search.",
            "default": true
          },
          "moreResults": {
            "title": "Get more results (beyond 2,000)",
            "type": "boolean",
            "description": "mobile.de stops every search at 2,000 results. On: a larger search is split into price bands of up to 2,000 results each (using mobile.de's price filter) and every band is read, duplicates removed.",
            "default": false
          },
          "includeDetails": {
            "title": "Include full details",
            "type": "boolean",
            "description": "Open every listing for equipment (features), description, all attributes (colour, seats, emission class, HU ...), dealer address / phone / opening hours / rating, finance offer and price-rating thresholds. One extra request per car. Off = the faster search-card data only.",
            "default": true
          },
          "reviewLimit": {
            "title": "Dealer review limit",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Newest reviews to add per dealer (from the dealer's public mobile.de ratings page, 10 per page; read once per dealer). Needs Include full details. 0 = no reviews. Example: 5",
            "default": 0
          },
          "language": {
            "title": "Language of labels",
            "enum": [
              "en",
              "de"
            ],
            "type": "string",
            "description": "Language of mobile.de's labels in the output (fuel, transmission, attributes, price rating ...).",
            "default": "en"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Listings opened in parallel for full details (each with its own proxy session). Example: 3",
            "default": 3
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "mobile.de is a German site; a German residential proxy is the default. The app API used here also answered from other countries in tests.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "DE"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}