{
  "openapi": "3.0.1",
  "info": {
    "title": "Sauto.cz Scraper ($0.85/1K): Czech Used Cars & Prices",
    "description": "Scrape Sauto.cz, the largest Czech car marketplace: cars, vans, trucks, motorbikes and more by make, model and every website filter. Price, mileage, year, VIN, equipment, dealers; deal score, monitoring of new, cheaper and sold cars, alerts. Ojeté vozy Sauto.cz.",
    "version": "0.0",
    "x-build-id": "hrPRBrsa7ypQc3F6D"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~sauto-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-sauto-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/tsutseisoftware~sauto-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-sauto-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/tsutseisoftware~sauto-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-sauto-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": {
          "searches": {
            "title": "Make and model",
            "type": "array",
            "description": "One search per line: a make, or a make and a model as Sauto.cz names them (\"Skoda Octavia\", \"Volkswagen Golf\", \"BMW X5\", \"Mercedes-Benz C\", \"Tesla\"). Accents and capitals do not matter. The filters below apply to every line. Empty = the whole category with your filters.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category",
            "enum": [
              "osobni",
              "uzitkova",
              "nakladni",
              "motorky",
              "ctyrkolky",
              "privesy-navesy",
              "obytne",
              "pracovni-stroje",
              "autobusy"
            ],
            "type": "string",
            "description": "Which section of Sauto.cz to search. The make, model and filters belong to it.",
            "default": "osobni"
          },
          "startUrls": {
            "title": "Sauto.cz URLs",
            "type": "array",
            "description": "Search pages copied from the browser with all their filters (https://www.sauto.cz/inzerce/osobni/skoda/octavia?palivo=nafta&vyrobeno-od=2018), listing URLs (read with their details) and dealer pages (https://www.sauto.cz/detail-prodejce/<name>/<number>: the dealer's whole stock).",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "maxItems": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "How many rows to save at most (cars, or dealers in the dealers mode); 0 = no limit. Up to 1,000 cars come in one request, so big runs are quick.",
            "default": 100
          },
          "dealerIds": {
            "title": "Dealer IDs",
            "type": "array",
            "description": "Read the whole stock of these dealers (the dealerId field of the output, e.g. 2173484). Combined with \"Make and model\", only those cars of each dealer.",
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Words of the version or title, as the website's own search field \"Varianta\" (e.g. \"RS\", \"4x4\", \"DSG\")."
          },
          "outputType": {
            "title": "Output",
            "enum": [
              "cars",
              "dealers"
            ],
            "type": "string",
            "description": "Cars: one row per listing. Dealers: one row per car dealer that has listings in your searches (or, without a search, every dealer on Sauto.cz), with its company ID (IČO), address, map point, website, rating, opening hours, social links and number of listings; charged as \"Dealer profile\" ($0.99 per 1,000 dealers) besides the row.",
            "default": "cars"
          },
          "conditions": {
            "title": "Condition",
            "type": "array",
            "description": "Empty = new, used and demonstration cars (the website's default, without damaged cars and classics).",
            "items": {
              "type": "string",
              "enum": [
                "nove",
                "ojete",
                "predvadeci",
                "havarovane",
                "veteran"
              ],
              "enumTitles": [
                "New",
                "Used",
                "Demonstration",
                "Damaged",
                "Classic"
              ]
            }
          },
          "priceFrom": {
            "title": "Price from (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in Czech koruna."
          },
          "priceTo": {
            "title": "Price up to (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in Czech koruna."
          },
          "yearFrom": {
            "title": "Year of manufacture from",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Oldest year of manufacture."
          },
          "yearTo": {
            "title": "Year of manufacture up to",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Newest year of manufacture."
          },
          "mileageFrom": {
            "title": "Mileage from (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest mileage."
          },
          "mileageTo": {
            "title": "Mileage up to (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest mileage."
          },
          "fuels": {
            "title": "Fuel",
            "type": "array",
            "description": "Only these fuels. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "benzin",
                "nafta",
                "lpg-benzin",
                "cng-benzin",
                "elektro",
                "hybridni",
                "ethanol",
                "vodik",
                "jine"
              ],
              "enumTitles": [
                "Petrol",
                "Diesel",
                "LPG + petrol",
                "CNG + petrol",
                "Electric",
                "Hybrid",
                "Ethanol",
                "Hydrogen",
                "Other"
              ]
            }
          },
          "gearboxes": {
            "title": "Gearbox",
            "type": "array",
            "description": "Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "manualni",
                "poloautomaticka",
                "automaticka"
              ],
              "enumTitles": [
                "Manual",
                "Semi-automatic",
                "Automatic"
              ]
            }
          },
          "bodyTypes": {
            "title": "Body type",
            "type": "array",
            "description": "Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "kombi",
                "suv",
                "sedanlimuzina",
                "kabriolet",
                "hatchback",
                "kupe",
                "mpv",
                "liftback",
                "pick-up",
                "terenni",
                "van",
                "roadster",
                "cuv"
              ],
              "enumTitles": [
                "Estate",
                "SUV",
                "Sedan",
                "Convertible",
                "Hatchback",
                "Coupe",
                "MPV",
                "Liftback",
                "Pick-up",
                "Off-road",
                "Van",
                "Roadster",
                "CUV"
              ]
            }
          },
          "powerFromKw": {
            "title": "Power from (kW)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest engine power in kW."
          },
          "powerToKw": {
            "title": "Power up to (kW)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest engine power in kW."
          },
          "engineVolumeFrom": {
            "title": "Engine from (cm³)",
            "minimum": 0,
            "type": "integer",
            "description": "Smallest engine displacement."
          },
          "engineVolumeTo": {
            "title": "Engine up to (cm³)",
            "minimum": 0,
            "type": "integer",
            "description": "Largest engine displacement."
          },
          "drives": {
            "title": "Drive",
            "type": "array",
            "description": "Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "4x4",
                "pohon-prednich-kol",
                "pohon-zadnich-kol"
              ],
              "enumTitles": [
                "4x4",
                "Front-wheel drive",
                "Rear-wheel drive"
              ]
            }
          },
          "sellerType": {
            "title": "Seller type",
            "enum": [
              "all",
              "dealer",
              "private"
            ],
            "type": "string",
            "description": "Who sells the car.",
            "default": "all"
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Only cars in these regions (kraj). Empty = the whole Czech Republic.",
            "items": {
              "type": "string",
              "enum": [
                "hlavni-mesto-praha",
                "jihocesky-kraj",
                "jihomoravsky-kraj",
                "karlovarsky-kraj",
                "kraj-vysocina",
                "kralovehradecky-kraj",
                "liberecky-kraj",
                "moravskoslezsky-kraj",
                "olomoucky-kraj",
                "pardubicky-kraj",
                "plzensky-kraj",
                "stredocesky-kraj",
                "ustecky-kraj",
                "zlinsky-kraj"
              ],
              "enumTitles": [
                "Prague (Hlavní město Praha)",
                "South Bohemia (Jihočeský kraj)",
                "South Moravia (Jihomoravský kraj)",
                "Karlovy Vary (Karlovarský kraj)",
                "Vysočina (Kraj Vysočina)",
                "Hradec Králové (Královéhradecký kraj)",
                "Liberec (Liberecký kraj)",
                "Moravia-Silesia (Moravskoslezský kraj)",
                "Olomouc (Olomoucký kraj)",
                "Pardubice (Pardubický kraj)",
                "Plzeň (Plzeňský kraj)",
                "Central Bohemia (Středočeský kraj)",
                "Ústí nad Labem (Ústecký kraj)",
                "Zlín (Zlínský kraj)"
              ]
            }
          },
          "districts": {
            "title": "Districts",
            "type": "array",
            "description": "Only cars in these districts (okres) as in Sauto.cz URLs, e.g. brno-mesto, praha-vychod, plzen-mesto, ostrava-mesto.",
            "items": {
              "type": "string"
            }
          },
          "listingAge": {
            "title": "Listed within",
            "enum": [
              "dnes",
              "1-den",
              "2-dny",
              "5-dni",
              "tyden",
              "2-tydny",
              "mesic"
            ],
            "type": "string",
            "description": "Only listings put on Sauto.cz (or renewed) within this time."
          },
          "colors": {
            "title": "Colour",
            "type": "array",
            "description": "Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "bila",
                "bezova",
                "bronzova",
                "cerna",
                "cervena",
                "fialova",
                "hneda",
                "modra",
                "oranzova",
                "ruzova",
                "stribrna",
                "seda",
                "vinova",
                "zelena",
                "zlata",
                "zluta",
                "jina"
              ],
              "enumTitles": [
                "White",
                "Beige",
                "Bronze",
                "Black",
                "Red",
                "Purple",
                "Brown",
                "Blue",
                "Orange",
                "Pink",
                "Silver",
                "Grey",
                "Burgundy",
                "Green",
                "Gold",
                "Yellow",
                "Other"
              ]
            }
          },
          "airConditioning": {
            "title": "Air conditioning",
            "type": "array",
            "description": "Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "bez-klimatizace",
                "manualni",
                "automaticka",
                "dvouzonova-automaticka",
                "trizonova-automaticka",
                "ctyrzonova-automaticka"
              ],
              "enumTitles": [
                "None",
                "Manual",
                "Automatic",
                "Dual-zone automatic",
                "Three-zone automatic",
                "Four-zone automatic"
              ]
            }
          },
          "countriesOfOrigin": {
            "title": "Country of origin",
            "type": "array",
            "description": "Where the car was first sold (imported cars). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "ceska-republika",
                "slovenska-republika",
                "francie",
                "italie",
                "nemecko",
                "rakousko",
                "svycarsko",
                "holandsko",
                "lucembursko",
                "belgie",
                "spanelsko",
                "dansko",
                "usa",
                "svedsko",
                "polsko",
                "jina",
                "nedohledatelny-puvod"
              ],
              "enumTitles": [
                "Czechia",
                "Slovakia",
                "France",
                "Italy",
                "Germany",
                "Austria",
                "Switzerland",
                "Netherlands",
                "Luxembourg",
                "Belgium",
                "Spain",
                "Denmark",
                "USA",
                "Sweden",
                "Poland",
                "Other",
                "Unknown origin"
              ]
            }
          },
          "certifiedPrograms": {
            "title": "Certified programme",
            "type": "array",
            "description": "Only cars checked by Cebia or a maker's used-car programme (ŠKODA Plus, Das WeltAuto...).",
            "items": {
              "type": "string",
              "enum": [
                "cebia",
                "skoda-plus",
                "das-weltauto",
                "citroen-select",
                "peugeot-vyzkousene-vozy",
                "emil-frey-select",
                "garant-",
                "opel-vyzkousene-vozy"
              ],
              "enumTitles": [
                "Cebia",
                "ŠKODA Plus",
                "Das WeltAuto",
                "Citroën Select",
                "Peugeot tested cars",
                "Emil Frey Select",
                "GARANT +",
                "Opel tested cars"
              ]
            }
          },
          "history": {
            "title": "History",
            "type": "array",
            "description": "Only cars with all of these (first owner, valid technical inspection, service book...).",
            "items": {
              "type": "string",
              "enum": [
                "prvni-majitel",
                "stk",
                "servisni-knizka",
                "v-minulosti-havarovano",
                "zaplacena-ekologicka-dan"
              ],
              "enumTitles": [
                "First owner",
                "Valid technical inspection (STK)",
                "Service book",
                "Damaged in the past",
                "Eco tax paid"
              ]
            }
          },
          "priceOptions": {
            "title": "Price options",
            "type": "array",
            "description": "Only cars with a leasing price or with VAT that a company can deduct.",
            "items": {
              "type": "string",
              "enum": [
                "cena-leasing",
                "odpocet-dph"
              ],
              "enumTitles": [
                "Leasing price",
                "VAT deductible"
              ]
            }
          },
          "equipment": {
            "title": "Equipment",
            "type": "array",
            "description": "Only cars with all of this equipment (tow bar, heated seats, adaptive cruise control...).",
            "items": {
              "type": "string",
              "enum": [
                "360deg-monitorovaci-system-avm",
                "abs",
                "adaptivni-tempomat",
                "ambientni-led-osvetleni-interieru",
                "android-auto",
                "apple-car-play",
                "asistent-rozjezdu-do-kopce",
                "automaticke-sviceni",
                "bezdratova-nabijecka-mobilnich-telefonu-qi",
                "bezklickove-ovladani",
                "bi-xenony",
                "bluetooth",
                "centralni-zamykani",
                "dalkove-centralni-zamykani",
                "deaktivace-airbagu-spolujezdce",
                "digitalni-prijem-radia-dab",
                "digitalni-pristrojovy-stit",
                "dojezdove-rezervni-kolo",
                "el-ovladani-oken",
                "el-ovladany-kufr",
                "el-seriditelna-sedadla",
                "el-sklopna-zrcatka",
                "esp",
                "funkce-plynuleho-dovirani-dveri",
                "head-up-display",
                "hlidani-mrtveho-uhlu",
                "isofix",
                "kozena-sedadla",
                "kozene-calouneni",
                "laserova-svetla",
                "led-matrixove-svetlomety",
                "led-svetlomety-plnohodnotne",
                "lita-kola",
                "multifunkcni-volant",
                "nezavisle-topeni",
                "odvetravani-sedadel",
                "palubni-pocitac",
                "pamet-nastaveni-sedadla-ridice",
                "panoramaticka-strecha",
                "parkovaci-asistent",
                "parkovaci-kamera",
                "parkovaci-senzory",
                "posilovac-rizeni",
                "regulace-tuhosti-podvozku",
                "rozpoznavani-dopravnich-znacek",
                "satelitni-navigace",
                "senzor-steracu",
                "senzor-tlaku-v-pneumatikach",
                "sledovani-jizdniho-pruhu",
                "sledovani-unavy-ridice",
                "startstop-system",
                "stresni-okno",
                "system-nouzoveho-zastaveni",
                "tazne-zarizeni",
                "tempomat",
                "usb",
                "volba-jizdniho-rezimu",
                "vyhrivana-sedadla",
                "vyhrivane-celni-sklo",
                "vyhrivany-volant",
                "xenony",
                "zaruka",
                "parkovaci-senzory-predni",
                "parkovaci-senzory-zadni",
                "el-seriditelne-sedadlo-ridice",
                "vzduchove-odpruzeni",
                "elektricke-dovirani-zavazadloveho-prostoru",
                "el-nastavitelna-zadni-sedadla",
                "elektricke-tazne-zarizeni",
                "digitalni-pristrojova-deska",
                "ventilovana-zadni-sedadla",
                "wifi-hotspot",
                "vyhrivana-zadni-sedadla",
                "treti-rada-sedadel",
                "tepelne-cerpadlo",
                "multimedialni-system-bez-navigace",
                "front-assist",
                "lane-assist",
                "akusticka-skla",
                "priplatkovy-audiosystem",
                "sedadla-alcantara",
                "sportovni-paket",
                "elektricke-dovirani-dveri",
                "aux"
              ],
              "enumTitles": [
                "360° camera system",
                "ABS",
                "Adaptive cruise control",
                "Ambient LED interior lighting",
                "Android Auto",
                "Apple CarPlay",
                "Hill start assist",
                "Automatic headlights",
                "Wireless phone charger (Qi)",
                "Keyless entry",
                "Bi-xenon headlights",
                "Bluetooth",
                "Central locking",
                "Remote central locking",
                "Passenger airbag deactivation",
                "Digital radio (DAB)",
                "Digital instrument cluster",
                "Space-saver spare wheel",
                "Electric windows",
                "Electric tailgate",
                "Electric seats",
                "Electric folding mirrors",
                "ESP",
                "Soft-close doors",
                "Head-up display",
                "Blind spot monitoring",
                "Isofix",
                "Leather seats",
                "Leather upholstery",
                "Laser headlights",
                "LED matrix headlights",
                "Full LED headlights",
                "Alloy wheels",
                "Multifunction steering wheel",
                "Auxiliary heating",
                "Ventilated seats",
                "Trip computer",
                "Driver seat memory",
                "Panoramic roof",
                "Park assist",
                "Parking camera",
                "Parking sensors",
                "Power steering",
                "Adaptive suspension",
                "Traffic sign recognition",
                "Satellite navigation",
                "Rain sensor",
                "Tyre pressure sensor",
                "Lane departure warning",
                "Driver fatigue monitoring",
                "Start/stop system",
                "Sunroof",
                "Emergency braking",
                "Tow bar",
                "Cruise control",
                "USB",
                "Drive mode selection",
                "Heated seats",
                "Heated windscreen",
                "Heated steering wheel",
                "Xenon headlights",
                "Warranty",
                "Front parking sensors",
                "Rear parking sensors",
                "Electric driver seat",
                "Air suspension",
                "Electric boot closing",
                "Electric rear seats",
                "Electric tow bar",
                "Digital dashboard",
                "Ventilated rear seats",
                "Wi-Fi hotspot",
                "Heated rear seats",
                "Third seat row",
                "Heat pump",
                "Multimedia system without navigation",
                "Front Assist",
                "Lane Assist",
                "Acoustic glass",
                "Premium audio system",
                "Alcantara seats",
                "Sport package",
                "Electric door closing",
                "AUX input"
              ]
            }
          },
          "otherSpecifications": {
            "title": "Adapted for disabled drivers",
            "type": "array",
            "description": "Only cars adapted for disabled drivers.",
            "items": {
              "type": "string",
              "enum": [
                "upravy-pro-zdravotne-postizene"
              ],
              "enumTitles": [
                "Adapted for disabled drivers"
              ]
            }
          },
          "seatsFrom": {
            "title": "Seats from",
            "minimum": 0,
            "type": "integer",
            "description": "Fewest seats."
          },
          "seatsTo": {
            "title": "Seats up to",
            "minimum": 0,
            "type": "integer",
            "description": "Most seats."
          },
          "doorsFrom": {
            "title": "Doors from",
            "minimum": 0,
            "type": "integer",
            "description": "Fewest doors."
          },
          "doorsTo": {
            "title": "Doors up to",
            "minimum": 0,
            "type": "integer",
            "description": "Most doors."
          },
          "airbagsFrom": {
            "title": "Airbags from",
            "minimum": 0,
            "type": "integer",
            "description": "Fewest airbags."
          },
          "fuelConsumptionTo": {
            "title": "Fuel consumption up to (l/100 km)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest average fuel consumption."
          },
          "electricConsumptionTo": {
            "title": "Electric consumption up to (kWh/100 km)",
            "minimum": 0,
            "type": "integer",
            "description": "Electric cars: highest consumption."
          },
          "batteryCapacityFrom": {
            "title": "Battery from (kWh)",
            "minimum": 0,
            "type": "integer",
            "description": "Electric cars: smallest battery capacity."
          },
          "batteryHealthFrom": {
            "title": "Battery health from (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Electric cars: lowest battery state of health."
          },
          "rangeFromKm": {
            "title": "Range from (km)",
            "minimum": 0,
            "type": "integer",
            "description": "Electric cars: shortest range."
          },
          "weightFrom": {
            "title": "Weight from (kg)",
            "minimum": 0,
            "type": "integer",
            "description": "Vans, trucks, trailers: lowest weight."
          },
          "weightTo": {
            "title": "Weight up to (kg)",
            "minimum": 0,
            "type": "integer",
            "description": "Vans, trucks, trailers: highest weight."
          },
          "bedsFrom": {
            "title": "Beds from",
            "minimum": 0,
            "type": "integer",
            "description": "Campers and caravans: fewest beds."
          },
          "machineHoursTo": {
            "title": "Machine hours up to",
            "minimum": 0,
            "type": "integer",
            "description": "Work machinery: most machine hours."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "cheapest",
              "most-expensive",
              "lowest-mileage",
              "newest-year"
            ],
            "type": "string",
            "description": "Order of the results. \"Newest first\" is the website's own order: new listings and freshly promoted ones first. A search read in price ranges (over 10,000 listings) keeps the order inside each range.",
            "default": "newest"
          },
          "maxItemsPerSearch": {
            "title": "Max listings per search",
            "minimum": 0,
            "type": "integer",
            "description": "At most this many cars from each search, make and model line or URL. Empty = no limit."
          },
          "splitLargeSearches": {
            "title": "Read searches over 10,000 listings",
            "type": "boolean",
            "description": "Sauto.cz shows at most 10,000 listings of one search. On: a bigger search is read in price ranges so that all of it comes (the whole car market, about 110,000 listings, in one run). Off: the first 10,000.",
            "default": true
          },
          "includeDetails": {
            "title": "Add car details",
            "type": "boolean",
            "description": "Opens every saved listing for the VIN (unless the seller hid it), the full equipment list (in English and Czech, also by group), engine power (kW and hp) and displacement, body type, colour, drive, gears, doors, seats, first owner, service book, technical inspection date, damaged in the past, VAT price, leasing price, description, all photos and videos, the map point, and the dealer's business card (company ID IČO, address, map point, website, Firmy.cz page, rating, opening hours, social links). Charged as \"Car details\" ($1.00 per 1,000 listings with details). Slower: about 4 listings a second.",
            "default": false
          },
          "includeContacts": {
            "title": "Contact person (personal data)",
            "type": "boolean",
            "description": "Dealers only: the dealer's e-mail addresses, phone numbers (also the one behind the website's \"Show phone\" button) and the names of its contact persons, in their own fields (dealerEmails, dealerPhones, phone, contactNames). Off by default. These are personal data when they belong to a person: you are responsible for processing them lawfully (GDPR) and for the anti-spam rules. They never appear in the log or in notifications. Charged as \"Contact details\" ($0.10 per 1,000 rows that have at least one). Turns \"Add car details\" on.",
            "default": false
          },
          "includePhoneNumbers": {
            "title": "Private sellers' phone numbers (personal data)",
            "type": "boolean",
            "description": "Private sellers only: the phone number the website shows behind its \"Show phone\" button (field phone; dealers' numbers come with \"Contact person\"). Off by default; a number the seller chose not to show is never returned. These are personal data when they belong to a person: you are responsible for processing them lawfully (GDPR) and for the anti-spam rules. They never appear in the log or in notifications. Charged as \"Phone number\" ($0.10 per 1,000 rows that have one). Turns \"Add car details\" on.",
            "default": false
          },
          "includePriceHistory": {
            "title": "Add price history",
            "type": "boolean",
            "description": "Every price this actor has seen for the car in your earlier runs (with the same Monitoring key): since when the price holds, number of changes, lowest price in 30 and 90 days, highest and average price in 90 days. Best with a scheduled run. Charged as \"Price history\" ($0.30 per 1,000 listings with history).",
            "default": false
          },
          "dealScoreWholeMarket": {
            "title": "Deal score against the whole market",
            "type": "boolean",
            "description": "The deal score compares every car with comparable cars (same make, model and fuel, a year apart, similar mileage) of your searches. On: with every listing of the same make and model in the Czech Republic (the newest 3,000 of each, at most 50 models a run). Charged as \"Extra page\" (one per 1,000 cars read for the comparison).",
            "default": false
          },
          "addPriceInEur": {
            "title": "Add the price in euros",
            "type": "boolean",
            "description": "The price converted to euros at the European Central Bank's rate of the day (field priceEur). Free.",
            "default": false
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only cars whose title or version contains at least one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Leave out cars whose title or version contains any of these words (e.g. \"na díly\", \"bez STK\").",
            "items": {
              "type": "string"
            }
          },
          "descriptionKeywords": {
            "title": "Description must contain",
            "type": "array",
            "description": "With \"Add car details\": keep only cars whose description contains at least one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeDescriptionKeywords": {
            "title": "Description must not contain",
            "type": "array",
            "description": "With \"Add car details\": leave out cars whose description contains any of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeTopped": {
            "title": "Leave out promoted listings",
            "type": "boolean",
            "description": "Leave out listings their sellers pay to keep on top.",
            "default": false
          },
          "onlyWithPrice": {
            "title": "Only with a price",
            "type": "boolean",
            "description": "Leave out listings with the price \"by agreement\".",
            "default": false
          },
          "excludeDealers": {
            "title": "Exclude dealers",
            "type": "array",
            "description": "Leave out cars of these dealers (name or dealer ID), e.g. your own stock in a market check.",
            "items": {
              "type": "string"
            }
          },
          "minDealScore": {
            "title": "Min deal score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Keep only cars with at least this deal score (50 = the usual price of comparable cars, higher = cheaper). Cars without enough comparable cars are left out."
          },
          "maxPriceVsMedianPercent": {
            "title": "Max price vs. comparable cars (%)",
            "type": "integer",
            "description": "Keep only cars at most this much above the median of comparable cars, e.g. -10 = at least 10 % cheaper."
          },
          "dealerName": {
            "title": "Dealer name contains",
            "type": "string",
            "description": "Only dealers whose name contains this text (e.g. \"Škoda\", \"AAA AUTO\")."
          },
          "dealerRegions": {
            "title": "Dealer regions",
            "type": "array",
            "description": "Only dealers based in these regions. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "hlavni-mesto-praha",
                "jihocesky-kraj",
                "jihomoravsky-kraj",
                "karlovarsky-kraj",
                "kraj-vysocina",
                "kralovehradecky-kraj",
                "liberecky-kraj",
                "moravskoslezsky-kraj",
                "olomoucky-kraj",
                "pardubicky-kraj",
                "plzensky-kraj",
                "stredocesky-kraj",
                "ustecky-kraj",
                "zlinsky-kraj"
              ],
              "enumTitles": [
                "Prague (Hlavní město Praha)",
                "South Bohemia (Jihočeský kraj)",
                "South Moravia (Jihomoravský kraj)",
                "Karlovy Vary (Karlovarský kraj)",
                "Vysočina (Kraj Vysočina)",
                "Hradec Králové (Královéhradecký kraj)",
                "Liberec (Liberecký kraj)",
                "Moravia-Silesia (Moravskoslezský kraj)",
                "Olomouc (Olomoucký kraj)",
                "Pardubice (Pardubický kraj)",
                "Plzeň (Plzeňský kraj)",
                "Central Bohemia (Středočeský kraj)",
                "Ústí nad Labem (Ústecký kraj)",
                "Zlín (Zlínský kraj)"
              ]
            }
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed listings",
            "type": "boolean",
            "description": "The first run saves everything and remembers it; later runs save only new listings and listings whose price changed (with the previous price). \"New\" means listed since the previous run: an older listing that only moved into your search is remembered without being returned (see below). The whole search is read every run, at most 25,000 listings per Monitoring key.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for every saved search. Empty = \"default\"."
          },
          "includeRemovedListings": {
            "title": "Monitoring: report sold and removed listings",
            "type": "boolean",
            "description": "Also a row for every listing that disappeared since the previous run, with the reason Sauto.cz gives (sold or taken down by the seller, expired, removed by the website, relisted under a new ID), the days it was listed and its last price. Checked only when the run read every search to its end.",
            "default": false
          },
          "includeUnchanged": {
            "title": "Monitoring: include unchanged listings",
            "type": "boolean",
            "description": "Also save the listings that did not change (changeType \"unchanged\").",
            "default": false
          },
          "onlyNew": {
            "title": "Monitoring: only new listings",
            "type": "boolean",
            "description": "Only newly listed cars, no price changes.",
            "default": false
          },
          "onlyPriceDrops": {
            "title": "Monitoring: only price drops",
            "type": "boolean",
            "description": "Of the changed listings only those that got cheaper.",
            "default": false
          },
          "minPriceChangePercent": {
            "title": "Monitoring: min price change (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Ignore smaller price changes (e.g. 3 = at least 3 %). The new price becomes the base anyway."
          },
          "skipFirstRun": {
            "title": "Monitoring: silent first run",
            "type": "boolean",
            "description": "The first run only remembers the listings and saves nothing, so you get only real news from then on.",
            "default": false
          },
          "skipRelisted": {
            "title": "Monitoring: skip relisted cars",
            "type": "boolean",
            "description": "Leave out \"new\" listings that are the same car of the same seller listed again under a new ID.",
            "default": false
          },
          "newMeansNewListing": {
            "title": "Monitoring: new = newly listed",
            "type": "boolean",
            "description": "On: a listing put on Sauto.cz before the previous run that only moved into your search (a price change, a renewal) is remembered without being returned. Off: every listing not seen before is new.",
            "default": true
          },
          "resetMonitoring": {
            "title": "Monitoring: start again",
            "type": "boolean",
            "description": "Forget the remembered state of this Monitoring key and start again.",
            "default": false
          },
          "salesWindowDays": {
            "title": "Sales window (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Market summary with monitoring: listings sold or removed in this many days and the market days supply (active listings divided by the daily sales).",
            "default": 30
          },
          "priceBands": {
            "title": "Price bands (CZK)",
            "type": "array",
            "description": "Upper edges of price bands for the market summary, e.g. 100000, 200000, 400000: the summary counts the cars in each band.",
            "items": {
              "type": "string"
            }
          },
          "telegramBotToken": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Token of your bot from @BotFather."
          },
          "telegramChatId": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Chat to send to."
          },
          "slackWebhookUrl": {
            "title": "Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook (https://hooks.slack.com/...)."
          },
          "discordWebhookUrl": {
            "title": "Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "webhookUrl": {
            "title": "Webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): receives the cars as JSON."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp access token",
            "type": "string",
            "description": "Access token of the WhatsApp Cloud API of your Meta business account, used with \"WhatsApp phone number ID\" and \"WhatsApp recipient number\" (step by step in the README, section \"WhatsApp notifications: setup\"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp phone number ID",
            "type": "string",
            "description": "ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID."
          },
          "whatsappTo": {
            "title": "WhatsApp recipient number",
            "type": "string",
            "description": "Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted."
          },
          "whatsappTemplateName": {
            "title": "WhatsApp template name",
            "type": "string",
            "description": "Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section \"WhatsApp notifications: setup\")."
          },
          "whatsappTemplateLanguage": {
            "title": "WhatsApp template language",
            "type": "string",
            "description": "Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with \"WhatsApp template name\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Max cars per notification",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many cars the message lists.",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notify only when something was found",
            "type": "boolean",
            "description": "No message after a run that saved nothing.",
            "default": true
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the main fields: title, make, model, version, price, mileage, year, fuel, gearbox, power, body, region, district, seller, photo, deal score, monitoring fields, URL.",
            "default": false
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "Rows without the fields that have no value (smaller files; every row may have other columns).",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description length limit",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. Empty = whole."
          },
          "exportFormats": {
            "title": "Extra export formats",
            "type": "array",
            "description": "Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.",
            "items": {
              "type": "string",
              "enum": [
                "html",
                "markdown"
              ],
              "enumTitles": [
                "Printable HTML report",
                "Markdown table"
              ]
            },
            "default": []
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy needed: Sauto.cz answers directly. If it keeps refusing your runs, switch to Apify Proxy (automatic).",
            "default": {
              "useApifyProxy": false
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}