{
  "openapi": "3.0.1",
  "info": {
    "title": "AutoScout24 Scraper — Full Market, 8 Countries & Price Ratings",
    "description": "Scrape car listings from AutoScout24 in Germany, Italy, France, Spain, the Netherlands, Belgium, Austria and Luxembourg, or all Europe at once. Filter by make, model, price, year, mileage, fuel, gearbox, seller and location, or paste a search URL.",
    "version": "0.1",
    "x-build-id": "2xwnDc70Jjklb8MJe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~autoscout24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-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/rastriq~autoscout24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-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/rastriq~autoscout24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-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": {
          "urls": {
            "title": "🔗 Search URLs",
            "type": "array",
            "description": "<b>Paste AutoScout24 search URLs to scrape them as they are.</b><br><br>Build your search on the website with any filter (make, model, equipment, colour, location…), then copy the address bar here, e.g. <code>https://www.autoscout24.de/lst/bmw/x3?fregfrom=2021&fuel=D</code>.<br><br>Search pages only (<code>/lst/…</code>); single listing pages are skipped. Several URLs and countries can be mixed in one run. In URL mode the URL decides market, filters and sort order; the <b>Limits</b>, <b>Advanced</b> and <b>Privacy</b> settings still apply.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "🌍 Country / market",
            "enum": [
              "de",
              "it",
              "fr",
              "es",
              "nl",
              "be",
              "at",
              "lu",
              "com",
              "pl",
              "ch",
              "pt"
            ],
            "type": "string",
            "description": "AutoScout24 market to search. Each market has its own domain and local prices. <b>All Europe</b> searches every market at once; narrow it with <b>Listing countries</b> under Location.",
            "default": "com"
          },
          "makes": {
            "title": "🏷️ Makes (brands)",
            "type": "array",
            "description": "Brands to collect, as they appear in AutoScout24 URLs: lowercase, hyphens for spaces — <code>bmw</code>, <code>mercedes-benz</code>, <code>alfa-romeo</code>, <code>land-rover</code>, <code>ds-automobiles</code>. Leave empty to collect 63 major brands.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "models": {
            "title": "🚗 Models",
            "type": "array",
            "description": "Optional. Model slugs as in AutoScout24 URLs — <code>500</code>, <code>x3</code>, <code>golf</code>, <code>c-klasse</code>. Each make is searched once per model (make × model). Leave empty for all models.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "priceFrom": {
            "title": "💶 Min price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or above this amount."
          },
          "priceTo": {
            "title": "💶 Max price (€)",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings priced at or below this amount."
          },
          "minYear": {
            "title": "📅 Min year (first registration)",
            "minimum": 1900,
            "maximum": 2027,
            "type": "integer",
            "description": "Only vehicles first registered in this year or later."
          },
          "maxYear": {
            "title": "📅 Max year (first registration)",
            "minimum": 1900,
            "maximum": 2027,
            "type": "integer",
            "description": "Only vehicles first registered in this year or earlier."
          },
          "minKm": {
            "title": "🛣️ Min mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Only vehicles with this mileage or more."
          },
          "maxKm": {
            "title": "🛣️ Max mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Only vehicles with this mileage or less."
          },
          "fuelTypes": {
            "title": "⛽ Fuel type",
            "type": "array",
            "description": "One or more fuel types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "B",
                "D",
                "E",
                "2",
                "3",
                "L",
                "C",
                "H",
                "M",
                "O"
              ],
              "enumTitles": [
                "Petrol",
                "Diesel",
                "Electric",
                "Hybrid (electric/petrol)",
                "Hybrid (electric/diesel)",
                "LPG",
                "CNG",
                "Hydrogen",
                "Ethanol",
                "Other"
              ]
            }
          },
          "gearbox": {
            "title": "⚙️ Gearbox",
            "type": "array",
            "description": "One or more gearbox types. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "A",
                "M",
                "S"
              ],
              "enumTitles": [
                "Automatic",
                "Manual",
                "Semi-automatic"
              ]
            }
          },
          "sellerType": {
            "title": "👤 Seller type",
            "enum": [
              "all",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Restrict to dealers or private sellers.",
            "default": "all"
          },
          "offerTypes": {
            "title": "🏷️ Offer type",
            "type": "array",
            "description": "One or more offer types. Empty = all used and new vehicles.",
            "items": {
              "type": "string",
              "enum": [
                "U",
                "N",
                "D",
                "S",
                "J",
                "O"
              ],
              "enumTitles": [
                "Used",
                "New",
                "Demonstration",
                "Pre-registered",
                "Employee's car",
                "Classic"
              ]
            }
          },
          "zipCode": {
            "title": "📮 Postal code",
            "type": "string",
            "description": "Search around a postal code of the selected market (e.g. <code>10115</code> Berlin, <code>28001</code> Madrid). Combine with <b>Radius</b>. AutoScout24 also mixes in cars sold with home delivery from further away; they are marked <code>ext_search_result_type = \"Deliverable\"</code>."
          },
          "radiusKm": {
            "title": "📏 Radius (km)",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Distance around the postal code. Ignored unless <b>Postal code</b> is set.",
            "default": 50
          },
          "listingCountries": {
            "title": "🗺️ Listing countries",
            "type": "array",
            "description": "Only listings located in these countries. Most useful with <b>All Europe</b> to compare a few markets in one run. Empty = all countries of the selected domain.",
            "items": {
              "type": "string",
              "enum": [
                "D",
                "I",
                "F",
                "E",
                "NL",
                "B",
                "A",
                "L"
              ],
              "enumTitles": [
                "Germany",
                "Italy",
                "France",
                "Spain",
                "Netherlands",
                "Belgium",
                "Austria",
                "Luxembourg"
              ]
            }
          },
          "maxItems": {
            "title": "📊 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on listings returned (you pay per listing). The run stops as soon as it reaches this number. <b>0 = no limit.</b>",
            "default": 100
          },
          "maxPages": {
            "title": "📑 Max pages per search",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Result pages per make/model search or URL (20 listings each, up to 200). Ignored when <b>Full coverage</b> is on.",
            "default": 20
          },
          "splitLargeSearches": {
            "title": "✂️ Full coverage (split large searches)",
            "type": "boolean",
            "description": "AutoScout24 serves only 4,000 listings per search. When on, larger searches are split automatically into price ranges so every priced listing is reached (e.g. all ~13,000 Fiat listings in Germany). Combine with <b>Max results = 0</b> for a full market snapshot. Slices are processed by price, so the global order only follows <b>Relevance</b> or <b>Price</b> sorting; with another sort and Max results up to 4,000 the Actor runs a single search instead.",
            "default": false
          },
          "sortBy": {
            "title": "📶 Sort order",
            "enum": [
              "standard",
              "newest",
              "price_asc",
              "price_desc",
              "mileage_asc",
              "year_desc"
            ],
            "type": "string",
            "description": "Order of the results. <b>Newest listings first</b> with a small Max results is the cheapest way to monitor new stock. Ignored in URL mode (the URL's own sort is used).",
            "default": "standard"
          },
          "maxConcurrency": {
            "title": "⚡ Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Parallel requests. 3 is fast and polite.",
            "default": 3
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy configuration",
            "type": "object",
            "description": "Apify datacenter proxy is enough for AutoScout24. The Actor rotates proxy sessions and retries automatically when it is rate-limited."
          },
          "stripSellerPII": {
            "title": "🔒 Strip seller personal data (GDPR)",
            "type": "boolean",
            "description": "<b>Remove personal data of private sellers from the output.</b><br>When enabled, <code>seller_phone</code>, <code>seller_name</code>, <code>seller_id</code>, <code>seller_url</code> and <code>ext_seller_id</code> are set to null for private (and unclassified) sellers. Dealer data is not affected.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}