{
  "openapi": "3.0.1",
  "info": {
    "title": "AutoScout24 Scraper — Used Car Listings & Prices API | $0.49/1k",
    "description": "Scrape AutoScout24 used car listings from every European country site: price, price rating, make, model, first registration, mileage, fuel, gearbox, power, location, dealer name and photos. Search by URL or by make, model, price and year. No login. Export CSV, JSON or Excel.",
    "version": "0.1",
    "x-build-id": "H0CQHb4nSlxZvdzyc"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/glasswing~autoscout24-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-glasswing-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/glasswing~autoscout24-scraper/runs": {
      "post": {
        "operationId": "runs-sync-glasswing-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/glasswing~autoscout24-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-glasswing-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 search URLs",
            "uniqueItems": true,
            "type": "array",
            "description": "Search result pages copied from your browser on any AutoScout24 country site, e.g. https://www.autoscout24.com/lst/bmw/x5?cy=D&priceto=40000. Every filter in the URL is kept. Listing pages (/offers/...) and other sites are not supported here and return one unbilled error row; look up single listings with Listing IDs below. You can leave the example in place when you use the search fields below: the untouched example is skipped automatically as soon as a search field is filled in.",
            "default": [
              "https://www.autoscout24.com/lst/bmw?atype=C&cy=D&sort=standard&desc=0"
            ],
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Maximum results",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many listings have been saved, across all searches. Each saved listing with status `ok` is one billable result. The site serves 20 listings per page and at most 200 pages (4,000 listings) per search; split bigger pulls by price or year ranges.",
            "default": 20
          },
          "make": {
            "title": "Make",
            "type": "string",
            "description": "Car make as AutoScout24 writes it in its URLs, e.g. bmw, volkswagen, mercedes-benz, audi, fiat, land-rover. Spaces and capitals are fine (\"Mercedes-Benz\" works). An unknown make returns one unbilled not_found row instead of unrelated cars."
          },
          "model": {
            "title": "Model",
            "type": "string",
            "description": "Model as AutoScout24 writes it in its URLs, e.g. x5, golf, a4, 500, clio. Needs Make. An unknown model returns one unbilled not_found row instead of every car of the make."
          },
          "country": {
            "title": "Country",
            "enum": [
              "DE",
              "AT",
              "BE",
              "ES",
              "FR",
              "IT",
              "LU",
              "NL"
            ],
            "type": "string",
            "description": "Only listings located in this country. Empty = all AutoScout24 countries."
          },
          "priceFrom": {
            "title": "Price from (EUR)",
            "minimum": 1,
            "type": "integer",
            "description": "Lowest asking price in euros, e.g. `5000`."
          },
          "priceTo": {
            "title": "Price up to (EUR)",
            "minimum": 1,
            "type": "integer",
            "description": "Highest asking price in euros, e.g. `20000`."
          },
          "yearFrom": {
            "title": "First registration from (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest year of first registration, e.g. 2018."
          },
          "yearTo": {
            "title": "First registration up to (year)",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest year of first registration, e.g. 2022."
          },
          "mileageMax": {
            "title": "Mileage up to (km)",
            "minimum": 1,
            "type": "integer",
            "description": "Highest mileage in kilometres, e.g. `100000`."
          },
          "fuel": {
            "title": "Fuel",
            "enum": [
              "gasoline",
              "diesel",
              "electric",
              "hybrid-gasoline",
              "hybrid-diesel",
              "lpg",
              "cng",
              "hydrogen",
              "ethanol",
              "other"
            ],
            "type": "string",
            "description": "Fuel type."
          },
          "bodyType": {
            "title": "Body type",
            "enum": [
              "compact",
              "convertible",
              "coupe",
              "suv",
              "station-wagon",
              "sedan",
              "van",
              "transporter",
              "other"
            ],
            "type": "string",
            "description": "Body type. When set, every row carries it in `bodyType` (the search page does not print it per listing otherwise)."
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Only dealer listings or only private listings. Empty = both."
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "standard",
              "price_asc",
              "price_desc",
              "year_desc",
              "mileage_asc",
              "power_desc",
              "age_desc"
            ],
            "type": "string",
            "description": "Order of the search built from the fields above (URLs keep their own order).",
            "default": "standard"
          },
          "domain": {
            "title": "Country site (language of the rows)",
            "enum": [
              "com",
              "de",
              "at",
              "it",
              "fr",
              "es",
              "nl",
              "lu",
              "pl"
            ],
            "type": "string",
            "description": "Which AutoScout24 site runs the search built from the fields. It only changes the language of text fields such as fuel and transmission (autoscout24.de answers \"Benzin\", .com \"Gasoline\"); use Country to choose where the cars are.",
            "default": "com"
          },
          "listingIds": {
            "title": "Listing IDs or listing URLs",
            "type": "array",
            "description": "Look up single listings: AutoScout24 listing IDs (the UUID at the end of a listing URL, e.g. `9d3ac0b9-7db1-4d0b-b10b-13ebaf1e989f`) or full listing URLs copied from your browser on any country site (a bare ID is looked up on autoscout24.com; a URL keeps its own country site and language). One row per listing with its current price and facts, in the same fields as a search row. No limit on the list; duplicates are removed and the lookups are never cut by Maximum results (which bounds the searches only). An ID that does not exist (sold or removed listing) returns one free `not_found` row. Use it to re-check the prices of listings you track.",
            "items": {
              "type": "string"
            }
          },
          "sourceDatasetId": {
            "title": "Source dataset ID (chain a search run)",
            "type": "string",
            "description": "Optional: the ID or name of a dataset from an earlier run, for example a search run of this Actor. Every row with a `listingId` (or an AutoScout24 listing `url`) becomes one listing lookup, added to the IDs above; rows with status `error` or `not_found` are skipped. The dataset must belong to your account."
          },
          "onlyNew": {
            "title": "Only new listings (watch mode)",
            "type": "boolean",
            "description": "Return only listings that an earlier run with this option on has not returned yet, so a scheduled run (hourly or daily) gives you just the new cars of your search. Already-seen listings are skipped and never charged; a search page with nothing new gives one free `not_found` row and that search stops there, so sort by Newest listings first. Seen listing IDs are kept in a named key-value store on your own Apify account (next field). The first run returns everything, like a normal run. Applies to searches, not to Listing IDs lookups.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Watch list name",
            "type": "string",
            "description": "Name of the key-value store on your account that remembers which listings were already returned. Use a different name per schedule to keep separate watch lists (e.g. `suv-germany`). Lowercase letters, digits and hyphens. Used only with Only new listings.",
            "default": "autoscout24-monitor"
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. The Actor works from Apify's datacenter without a proxy. Enable Apify Proxy (datacenter) only if you see blocked requests; residential proxies are not needed.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}