{
  "openapi": "3.0.1",
  "info": {
    "title": "AutoScout24 Scraper: 9 Countries, Price History & Price Alerts",
    "description": "Scrape AutoScout24 in all 9 countries, Switzerland included: full price history, AutoScout24's market price, dealer stock and seller phones, with no 4,000-result limit. Alerts for new listings, price drops, sold cars and reposts. From $0.35 per 1,000 listings, platform usage included.",
    "version": "0.0",
    "x-build-id": "zTGTSwySa2jnGIGkn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/epicscrapers~autoscout24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-epicscrapers-autoscout24-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/epicscrapers~autoscout24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-epicscrapers-autoscout24-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/epicscrapers~autoscout24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-epicscrapers-autoscout24-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": "AutoScout24 URLs",
            "type": "array",
            "description": "Paste URLs from any AutoScout24 site: search pages (autoscout24.de, .it, .fr, .es, .nl, .be, .at, .lu, .com, and autoscout24.ch for Switzerland) with any filters and sort you set on the site, e.g. https://www.autoscout24.de/lst/bmw/3er?fregfrom=2018&priceto=30000. Dealer pages (…/haendler/…, …/dealerinfo/…, autoscout24.ch …/s/seller-…) return the dealer's whole stock. Listing pages (…/angebote/…, …/offers/…, autoscout24.ch …/d/…) are scraped as single listings. Leave empty to use the filters below instead.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum listings saved per search URL (or for the filter search). AutoScout24 shows only 4,000 results per search; above that the Actor splits the search by price automatically, so 0 (no limit) really gets every listing.",
            "default": 100
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "keep",
              "standard",
              "newest",
              "price_asc",
              "price_desc",
              "mileage_asc",
              "year_desc",
              "power_desc"
            ],
            "type": "string",
            "description": "Order of the results. \"Keep\" uses the sort in each URL (or AutoScout24's standard order). For monitoring, use Newest first.",
            "default": "keep"
          },
          "vehicleType": {
            "title": "Vehicle type",
            "enum": [
              "car",
              "motorbike",
              "van",
              "caravan"
            ],
            "type": "string",
            "description": "Kind of vehicle to search.",
            "default": "car"
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Seller countries. Empty = the 8 EU countries (all except Switzerland). Switzerland is a separate AutoScout24 marketplace with prices in CHF; select it to search it too.",
            "items": {
              "type": "string",
              "enum": [
                "DE",
                "AT",
                "BE",
                "ES",
                "FR",
                "IT",
                "LU",
                "NL",
                "CH"
              ],
              "enumTitles": [
                "Germany",
                "Austria",
                "Belgium",
                "Spain",
                "France",
                "Italy",
                "Luxembourg",
                "Netherlands",
                "Switzerland (autoscout24.ch, CHF)"
              ]
            }
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Brand as written on AutoScout24, e.g. BMW, Volkswagen, Mercedes-Benz, Tesla."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "A model (Golf, 320, Model 3) or a model range (3 Series, A-Class). A range includes all its models. Needs a make."
          },
          "priceMin": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price, in EUR (CHF for Switzerland)."
          },
          "priceMax": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price, in EUR (CHF for Switzerland)."
          },
          "yearMin": {
            "title": "First registration from (year)",
            "minimum": 1900,
            "type": "integer",
            "description": "Earliest first-registration year."
          },
          "yearMax": {
            "title": "First registration to (year)",
            "minimum": 1900,
            "type": "integer",
            "description": "Latest first-registration year."
          },
          "mileageMax": {
            "title": "Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest mileage in km."
          },
          "fuelTypes": {
            "title": "Fuel",
            "type": "array",
            "description": "Only these fuel types. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "gasoline",
                "diesel",
                "electric",
                "hybrid_gasoline",
                "hybrid_diesel",
                "lpg",
                "cng",
                "hydrogen",
                "ethanol",
                "other"
              ],
              "enumTitles": [
                "Gasoline",
                "Diesel",
                "Electric",
                "Hybrid (electric/gasoline)",
                "Hybrid (electric/diesel)",
                "LPG",
                "CNG",
                "Hydrogen",
                "Ethanol",
                "Other"
              ]
            }
          },
          "gearbox": {
            "title": "Gearbox",
            "type": "array",
            "description": "Only these gearboxes. Empty = any.",
            "items": {
              "type": "string",
              "enum": [
                "automatic",
                "manual",
                "semi_automatic"
              ],
              "enumTitles": [
                "Automatic",
                "Manual",
                "Semi-automatic"
              ]
            }
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "used",
              "new"
            ],
            "type": "string",
            "description": "Used or new vehicles only.",
            "default": "any"
          },
          "sellerType": {
            "title": "Seller",
            "enum": [
              "any",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Dealers or private sellers only.",
            "default": "any"
          },
          "postalCode": {
            "title": "Postal code",
            "type": "string",
            "description": "Search around this postal code (in the selected country). Use with Radius. Not available for Switzerland."
          },
          "radiusKm": {
            "title": "Radius (km)",
            "minimum": 1,
            "type": "integer",
            "description": "Distance around the postal code, in km."
          },
          "onlyNewOrChanged": {
            "title": "Only new or changed listings",
            "type": "boolean",
            "description": "Save only listings that are new or changed price since the last run of the same search. The first run saves everything it finds, to learn what exists. Pair with Sort: Newest first, so each run reads only the newest page(s).",
            "default": false
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Name for this monitor's memory (e.g. \"bmw-3er-berlin\"). Runs with the same name and search continue from each other; use different names for independent monitors of the same search. Setting a name also adds changeType/previousPrice/isRepost to every row."
          },
          "detectRemovals": {
            "title": "Detect removed, reappeared and reposted listings",
            "type": "boolean",
            "description": "When monitoring, re-check listings from earlier runs that this run didn't see. Saves the ones that were removed (changeType \"removed\"), came back (\"reappeared\") or changed price, and flags new listings that are reposts of a removed one (isRepost, repostOfId). Re-checks are free; only resulting rows are charged.",
            "default": true
          },
          "skipReposts": {
            "title": "Skip reposts",
            "type": "boolean",
            "description": "When monitoring, don't save new listings that are reposts of a removed listing (same seller, car, registration and mileage). Useful when you only want genuinely new cars.",
            "default": false
          },
          "includeDescription": {
            "title": "Include seller's description",
            "type": "boolean",
            "description": "The free-text description written by the seller (as plain text).",
            "default": true
          },
          "includeEquipment": {
            "title": "Include equipment list",
            "type": "boolean",
            "description": "Equipment and options, e.g. Navigation system, Heated seats, Parking sensors.",
            "default": true
          },
          "descriptionMaxLength": {
            "title": "Max description length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters, e.g. to keep rows small for spreadsheets or AI tools. 0 = full description.",
            "default": 0
          },
          "compact": {
            "title": "Compact rows",
            "type": "boolean",
            "description": "Save about 25 core fields per listing (title, price, price rating, mileage, year, fuel, location, seller, link) instead of 80+. Monitoring fields are kept.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy used for AutoScout24 requests. The default Apify proxy works; change it only if you have a reason 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}