{
  "openapi": "3.0.1",
  "info": {
    "title": "AutoScout24 Scraper - Car Listings, Prices & Dealer Leads",
    "description": "Scrape AutoScout24 car listings across Germany, Austria, Italy, France, the Netherlands and Spain. Price, mileage, first registration and power come back as real numbers, with each seller's dealership, contact person and address. Dealer directory mode returns a lead list instead.",
    "version": "0.1",
    "x-build-id": "vgOaQSHIVF7HbAnJw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/webdata_labs~autoscout24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-webdata_labs-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/webdata_labs~autoscout24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-webdata_labs-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/webdata_labs~autoscout24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-webdata_labs-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": {
          "country": {
            "title": "Country",
            "enum": [
              "de",
              "at",
              "it",
              "fr",
              "nl",
              "es"
            ],
            "type": "string",
            "description": "Which AutoScout24 site to search. Each country has its own inventory, so this is the single most important field.",
            "default": "de"
          },
          "makes": {
            "title": "Makes",
            "type": "array",
            "description": "Car makes as they appear in an AutoScout24 URL, for example bmw, volkswagen or mercedes-benz. One search per make. Leave empty to search every make in the country.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "models": {
            "title": "Models",
            "type": "array",
            "description": "Model slugs to narrow the search, for example 3er or golf. A model belongs to one make, so these apply only when exactly one make is given, and are ignored otherwise.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "AutoScout24 search URLs you already have. Any /lst URL on a supported country site works and its own filters win over the fields below. Other AutoScout24 pages are rejected, because only the search page carries listing data.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "outputMode": {
            "title": "What to return",
            "enum": [
              "listings",
              "dealers"
            ],
            "type": "string",
            "description": "Car listings returns one row per car. Dealer directory returns one row per dealership instead, with its contact person, address, rating, how many cars it has listed and its price range. Dealer rows are what you want for a lead list.",
            "default": "listings"
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many rows across all searches: cars in listings mode, dealerships in dealer directory mode. Each row is one charged result.",
            "default": 200
          },
          "sort": {
            "title": "Sort",
            "enum": [
              "standard",
              "newest-listing",
              "price-asc",
              "price-desc",
              "mileage-asc",
              "year-desc",
              "power-desc"
            ],
            "type": "string",
            "description": "The order AutoScout24 returns listings in. Newest listing first is the one to use for a monitor, because the cars you have not seen are at the front.",
            "default": "standard"
          },
          "priceFrom": {
            "title": "Minimum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only cars asking at least this much. Leave empty for no lower bound."
          },
          "priceTo": {
            "title": "Maximum price (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only cars asking at most this much. Leave empty for no upper bound."
          },
          "firstRegistrationFrom": {
            "title": "First registered from (year)",
            "minimum": 1900,
            "type": "integer",
            "description": "Only cars first registered in this year or later, for example 2020."
          },
          "firstRegistrationTo": {
            "title": "First registered until (year)",
            "minimum": 1900,
            "type": "integer",
            "description": "Only cars first registered in this year or earlier."
          },
          "mileageTo": {
            "title": "Maximum mileage (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Only cars with at most this many kilometres on the clock, for example 50000."
          },
          "fuelType": {
            "title": "Fuel types",
            "type": "array",
            "description": "Only cars with one of these fuel types. Hybrid covers both petrol and diesel hybrids. Leave empty for all of them.",
            "items": {
              "type": "string",
              "enum": [
                "petrol",
                "diesel",
                "electric",
                "hybrid",
                "lpg",
                "cng"
              ],
              "enumTitles": [
                "Petrol",
                "Diesel",
                "Electric",
                "Hybrid",
                "LPG",
                "CNG"
              ]
            },
            "default": []
          },
          "transmission": {
            "title": "Transmission",
            "enum": [
              "automatic",
              "manual",
              "semi-automatic"
            ],
            "type": "string",
            "description": "Only cars with this gearbox. Leave empty for both."
          },
          "bodyType": {
            "title": "Body types",
            "type": "array",
            "description": "Only cars with one of these body types. Leave empty for all of them.",
            "items": {
              "type": "string",
              "enum": [
                "small-car",
                "convertible",
                "coupe",
                "suv",
                "station-wagon",
                "sedan",
                "van",
                "transporter"
              ],
              "enumTitles": [
                "Small car",
                "Convertible",
                "Coupe",
                "SUV / off-road",
                "Station wagon",
                "Sedan",
                "Van / minivan",
                "Transporter"
              ]
            },
            "default": []
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Only cars sold by dealers, or only by private sellers. Leave empty for both. Dealer directory mode ignores private sellers regardless."
          },
          "powerFromKw": {
            "title": "Minimum power (kW)",
            "minimum": 0,
            "type": "integer",
            "description": "Only cars with at least this much power in kilowatts. 100 kW is roughly 136 hp."
          },
          "includeDamaged": {
            "title": "Include damaged cars",
            "type": "boolean",
            "description": "AutoScout24 leaves accident and damaged vehicles out of its results by default. Switch this on to put them back in.",
            "default": false
          },
          "maxPagesPerQuery": {
            "title": "Maximum pages per search",
            "minimum": 0,
            "type": "integer",
            "description": "Optional cap on pages per search, 20 listings each. Leave at 0 to page until the search runs out. AutoScout24 serves at most 200 pages (4,000 listings) per search whatever this is set to, so split a big search by model or price band to go deeper.",
            "default": 0
          },
          "onlyNewListings": {
            "title": "Only results not seen before",
            "type": "boolean",
            "description": "Remember every row delivered by previous runs of this Actor and return only what is new since then. Nothing is charged when there is nothing new, which makes a scheduled run cheap.",
            "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}