{ "openapi": "3.0.1", "info": { "title": "AutoScout24 Scraper: EU Car Listings & Prices", "description": "Pull AutoScout24 car, motorbike, van and caravan ads from 8 EU countries on 11 sites, no login, beyond 4,000 rows a search. Rows hold price, price rating, mileage, first registration, kW, fuel, gearbox, dealer phones, English codes. Alerts for new ads; Excel, JSON or API; pay per listing.", "version": "0.1", "x-build-id": "OQovw3xnjmSOuZxat" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~autoscout24-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~autoscout24-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~autoscout24-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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": { "makeModels": { "title": "Makes and models", "type": "array", "description": "Makes, or makes with a model, as AutoScout24 lists them: \"Volkswagen\", \"Volkswagen Golf\", \"BMW 3er\", \"Mercedes-Benz C 200\", a whole model line with \"(all)\" (\"Volkswagen Golf (all)\"), and a version text after \" / \" (\"Volkswagen Golf / GTI\"). Ids work too (\"74\", \"74|2084\"). The names follow the vehicle type below.", "items": { "type": "string" } }, "makes": { "title": "Car makes (pick from the list)", "type": "array", "description": "Car makes picked from AutoScout24's own list (295 makes); each is searched like a make written in \"Makes and models\". Cars only.", "items": { "type": "string", "enum": [ "9ff", "Abarth", "AC", "ACM", "Acura", "Aerfal", "AION", "Aiways", "Aixam", "Alba Mobility", "Alfa Romeo", "Alpina", "Alpine", "Amphicar", "Angelelli Automobili", "ARI", "Ariel Motor", "Artega", "Aspark", "Aspid", "Aston Martin", "Audi", "Aurus", "Austin", "Austin-Healey", "Autobianchi", "BAIC", "BAW", "Bedford", "Bellier", "Bentley", "Bertone", "Bestune", "BMW", "Boldmen", "Bolloré", "Borgward", "Bovensiepen", "Brilliance", "Bristol", "Brute", "Bugatti", "Buick", "BYD", "Cadillac", "Carver", "Casalini", "Caterham", "Cenntro", "Chamonix", "Changan", "Changhe", "Chatenet", "Chery", "Chevrolet", "Chrysler", "Cirelli", "Citroen", "CityEL", "Corvette", "CUPRA", "Dacia", "Daewoo", "DAF", "Daihatsu", "Daimler", "Dallara", "Dangel", "De la Chapelle", "De Tomaso", "Delorean", "Denza", "Devalliet", "Devinci Cars", "DFM", "DFSK", "Dodge", "Dongfeng", "Donkervoort", "DR Automobiles", "DS Automobiles", "Dutton", "e.GO", "Ebro", "Econelo", "Edran", "Elaris", "Eli", "Embuggy", "EMC", "Estrima", "Evetta", "EVO", "Farizon", "Ferrari", "Fiat", "firefly", "Fisker", "Ford", "Forthing", "Foton", "Gac Gonow", "Galloper", "Gappy", "GAZ", "Geely", "GEM", "GEMBALLA", "Genesis", "Giana", "Gillet", "Giotti Victoria", "GMC", "Goupil", "Great Wall", "Grecav", "GTA", "GWM", "Haima", "Hamann", "Haval", "Hiphi", "Holden", "Honda", "Hongqi", "HUMMER", "Hurtan", "Hyundai", "ICH-X", "Ineos", "Infiniti", "Innocenti", "Invicta", "Iso Rivolta", "Isuzu", "Iveco", "IZH", "JAC", "Jaecoo", "Jaguar", "Jeep", "Jensen", "Jetour", "Jinpeng", "Karma", "KGM", "Kia", "Koenigsegg", "KTM", "KYBURZ", "Lada", "Lamborghini", "Lancia", "Land Rover", "LDV", "Leapmotor", "Lee Group", "Lepas", "LEVC", "Lexus", "Li", "Lifan", "Ligier", "Lincoln", "Linktour", "Linzda", "Livan", "Lorinser", "Lotus", "Lucid", "Lynk & Co", "Mahindra", "MAN", "Mansory", "Martin", "Martin Motors", "Maserati", "Matra", "Maxus", "Maybach", "Mazda", "McLaren", "Mega", "Melex", "Mercedes-Benz", "Mercury", "MG", "MHERO", "Micro", "Microcar", "Militem", "Minari", "Minauto", "MINI", "Mitsubishi", "Mitsuoka", "Mobilize", "Morgan", "Moskvich", "MP Lafer", "MPM Motors", "NIO", "Nissan", "NSU", "Oldsmobile", "Omoda", "Opel", "Ora", "Pagani", "Panther Westwinds", "Peugeot", "PGO", "Piaggio", "Plymouth", "Polestar", "Pontiac", "Porsche", "Proton", "Puch", "RAM", "Regis", "Reliant", "Renault", "Rimac", "Rivian", "Rolls-Royce", "Rover", "Ruf", "Saab", "Santana", "SEAT", "Segway", "Selvo", "Seres", "Sevic", "SGS", "Shelby", "Shuanghuan", "Silence", "Simplici", "Singer", "Skoda", "Skywell", "Skyworth", "smart", "SpeedArt", "Sportequipe", "Spyker", "SsangYong", "Stormborn", "StreetScooter", "Studebaker", "Subaru", "Sunbeam", "Suzuki", "SWM", "Talbot", "Tasso", "Tata", "Tazzari EV", "TECHART", "Tesla", "Tiger", "Togg", "Town Life", "Toyota", "Trabant", "Triumph", "TVR", "TYN-e", "UAZ", "Vanden Plas", "Vanderhall", "VAZ", "VEM", "Venucia", "VinFast", "Volkswagen", "Volvo", "Voyah", "Wartburg", "Weltmeister", "Wenckstern", "Westfield", "Wey", "Wiesmann", "XBus", "XEV", "Xiaomi", "Xpeng", "Zastava", "ZAZ", "Zeekr", "Zhidou", "Zotye" ] } }, "keywords": { "title": "Keywords", "type": "array", "description": "Free text AutoScout24 searches in the ads (its own keyword search), such as \"Panorama\", \"AHK\", \"garanzia\". Each keyword is its own search within the makes above.", "items": { "type": "string" } }, "vehicleType": { "title": "Vehicle type", "enum": [ "car", "motorbike", "van", "caravan" ], "type": "string", "description": "The kind of vehicle every built search reads. Default: cars. A search link carries its own type." }, "site": { "title": "AutoScout24 site", "enum": [ "de", "at", "it", "nl", "fr", "lu", "es", "com", "pl", "ro", "bg" ], "type": "string", "description": "The site whose ads and labels the built searches read. AutoScout24.de lists the most ads of every country (it held 98 to 99.5 percent of each country site's own ads and up to 84 percent more in the 2026-10-15 spike); another site gives its own share in its language. Every row also carries the coded values in English. Default: de." }, "countries": { "title": "Seller countries", "type": "array", "description": "The countries the cars are offered in. Default: all eight countries AutoScout24 lists ads from.", "items": { "type": "string", "enum": [ "DE", "AT", "BE", "ES", "FR", "IT", "LU", "NL" ], "enumTitles": [ "Germany", "Austria", "Belgium", "Spain", "France", "Italy", "Luxembourg", "Netherlands" ] } }, "locations": { "title": "Places (postcode or coordinates)", "type": "array", "description": "A postcode with its country (\"10115, DE\", \"20121, IT\", \"1010, AT\", \"1012, NL\" with the 4 digits; a postcode alone is German) or coordinates (\"52.52, 13.40\"). AutoScout24 resolves each postcode itself (once per run); a postcode it does not resolve is a free row. Place names are not taken (the site resolves some to the wrong place). Each place is searched with the radius below.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius in kilometres", "minimum": 1, "maximum": 1000, "type": "integer", "description": "The radius around each place in whole kilometres, 1 to 1,000 (AutoScout24's form offers 10 to 400). Default 50 km when a place is given." }, "dealers": { "title": "Dealers (their stock)", "type": "array", "description": "A dealer's stock: its dealer page link (https://www.autoscout24.de/haendler/, also .at, .it /concessionari/, .nl /autobedrijven/, .fr /garages/, .es /profesionales/) reads the whole stock; with makes above, the dealer id (the \"sellerId\" of its rows) or link searches its stock within those makes, with every filter.", "items": { "type": "string" } }, "searchUrls": { "title": "Search links", "type": "array", "description": "AutoScout24 search links copied from your browser after choosing a make and filters, on any site (https://www.autoscout24.it/lst/fiat/500?...). Each is read on its own site with its own filters and sort; a parameter this Actor does not know refuses the link (the site would ignore it and search wider). A link without a make is refused (robots.txt).", "items": { "type": "string" } }, "resumeFromDatasetId": { "title": "Resume from an earlier run (dataset id)", "type": "string", "description": "The dataset id of an earlier run of this Actor in your account (its \"defaultDatasetId\"). Ads delivered in it are left out, free, so an interrupted run can be continued without paying for an ad twice. At most 200,000 rows are read." }, "adUrls": { "title": "Ad links", "type": "array", "description": "Ad links of any AutoScout24 site, or ad ids, read with their details and delivered as given (billed as Listing by URL). A removed, unknown or online sale ad is a free row.", "items": { "type": "string" } }, "fuelTypes": { "title": "Fuel", "type": "array", "description": "Any of these fuels.", "items": { "type": "string", "enum": [ "petrol", "diesel", "electric", "hybrid_electric_petrol", "hybrid_electric_diesel", "lpg", "cng", "hydrogen", "ethanol", "other" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid (electric and petrol)", "Hybrid (electric and diesel)", "LPG", "CNG", "Hydrogen", "Ethanol", "Other" ] } }, "gearbox": { "title": "Gearbox", "type": "array", "description": "Any of these gearboxes.", "items": { "type": "string", "enum": [ "automatic", "manual", "semi_automatic" ], "enumTitles": [ "Automatic", "Manual", "Semi-automatic" ] } }, "bodyTypes": { "title": "Body type", "type": "array", "description": "Any of these body types (cars).", "items": { "type": "string", "enum": [ "compact", "convertible", "coupe", "suv", "estate", "sedan", "van", "transporter", "other" ], "enumTitles": [ "Compact", "Convertible", "Coupe", "SUV, off-road, pick-up", "Estate (station wagon)", "Sedan", "Van", "Transporter", "Other" ] } }, "conditions": { "title": "Condition", "type": "array", "description": "Any of these offer types.", "items": { "type": "string", "enum": [ "new", "used", "employee_car", "classic", "demonstration", "pre_registered" ], "enumTitles": [ "New", "Used", "Employee car", "Classic", "Demonstration car", "Pre-registered" ] } }, "sellerType": { "title": "Seller type", "enum": [ "any", "dealer", "private" ], "type": "string", "description": "Dealers, private sellers, or both (default)." }, "minPrice": { "title": "Price from (EUR)", "minimum": 0, "type": "integer", "description": "Lowest price in euros." }, "maxPrice": { "title": "Price up to (EUR)", "minimum": 0, "type": "integer", "description": "Highest price in euros." }, "yearMin": { "title": "First registration from (year)", "minimum": 1900, "type": "integer", "description": "Earliest year of first registration." }, "yearMax": { "title": "First registration up to (year)", "minimum": 1900, "type": "integer", "description": "Latest year of first registration." }, "mileageMin": { "title": "Mileage from (km)", "minimum": 0, "type": "integer", "description": "Lowest mileage in km." }, "mileageMax": { "title": "Mileage up to (km)", "minimum": 0, "type": "integer", "description": "Highest mileage in km." }, "powerMin": { "title": "Power from", "minimum": 0, "type": "integer", "description": "Lowest power, in the unit below (kW by default)." }, "powerMax": { "title": "Power up to", "minimum": 0, "type": "integer", "description": "Highest power, in the unit below (kW by default)." }, "powerUnit": { "title": "Power unit", "enum": [ "kw", "hp" ], "type": "string", "description": "The unit of \"Power from\" and \"Power up to\". Default kW." }, "colors": { "title": "Exterior colour", "type": "array", "description": "Any of these exterior colours.", "items": { "type": "string", "enum": [ "beige", "blue", "brown", "bronze", "yellow", "grey", "green", "red", "black", "silver", "violet", "white", "orange", "gold" ], "enumTitles": [ "Beige", "Blue", "Brown", "Bronze", "Yellow", "Grey", "Green", "Red", "Black", "Silver", "Violet", "White", "Orange", "Gold" ] } }, "interiorColors": { "title": "Interior colour", "type": "array", "description": "Any of these interior colours.", "items": { "type": "string", "enum": [ "beige", "black", "grey", "brown", "other", "blue", "red", "green", "yellow", "orange", "white" ], "enumTitles": [ "Beige", "Black", "Grey", "Brown", "Other", "Blue", "Red", "Green", "Yellow", "Orange", "White" ] } }, "upholstery": { "title": "Upholstery", "type": "array", "description": "Any of these upholsteries.", "items": { "type": "string", "enum": [ "alcantara", "cloth", "full_leather", "part_leather", "velour", "other" ], "enumTitles": [ "Alcantara", "Cloth", "Full leather", "Part leather", "Velour", "Other" ] } }, "paintTypes": { "title": "Paint", "type": "array", "description": "Any of these paint types.", "items": { "type": "string", "enum": [ "metallic", "pearl", "mica", "uni", "other" ], "enumTitles": [ "Metallic", "Pearl effect", "Mica", "Uni (basic)", "Other" ] } }, "cylinders": { "title": "Cylinders", "type": "array", "description": "Any of these cylinder counts.", "items": { "type": "string", "enum": [ "3", "4", "6", "8", "10_or_more" ], "enumTitles": [ "3", "4", "6", "8", "10 or more" ] } }, "driveTypes": { "title": "Drive", "type": "array", "description": "Any of these drives.", "items": { "type": "string", "enum": [ "all_wheel", "front", "rear" ], "enumTitles": [ "All wheel (4x4)", "Front wheel", "Rear wheel" ] } }, "priceRatings": { "title": "AutoScout24 price rating", "type": "array", "description": "Any of these AutoScout24 price ratings (its own rating against the market).", "items": { "type": "string", "enum": [ "very_good_price", "good_price", "fair_price", "increased_price", "high_price", "no_rating" ], "enumTitles": [ "Very good price", "Good price", "Fair price", "Increased price", "High price", "No rating" ] } }, "equipment": { "title": "Equipment (all of these)", "type": "array", "description": "Equipment every car must have, by its name in English or in the site's language, or its AutoScout24 number: \"Navigation system\", \"Panorama roof\", \"Trailer hitch\", \"Heated seats\", \"Full service history\", \"Non-smoking vehicle\" (136 items).", "items": { "type": "string" } }, "seals": { "title": "Quality seals", "type": "array", "description": "Cars with any of these quality seals, by name or number as the site lists them (such as \"Dekra Siegel\").", "items": { "type": "string" } }, "seatsMin": { "title": "Seats from", "minimum": 1, "maximum": 99, "type": "integer", "description": "Fewest seats." }, "seatsMax": { "title": "Seats up to", "minimum": 1, "maximum": 99, "type": "integer", "description": "Most seats." }, "doorsMin": { "title": "Doors from", "minimum": 2, "maximum": 9, "type": "integer", "description": "Fewest doors." }, "doorsMax": { "title": "Doors up to", "minimum": 2, "maximum": 9, "type": "integer", "description": "Most doors." }, "engineSizeMin": { "title": "Engine size from (ccm)", "minimum": 0, "maximum": 99999, "type": "integer", "description": "Smallest engine displacement in cubic centimetres." }, "engineSizeMax": { "title": "Engine size up to (ccm)", "minimum": 0, "maximum": 99999, "type": "integer", "description": "Largest engine displacement in cubic centimetres." }, "electricRangeMin": { "title": "Electric range from (km)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Shortest electric range in km." }, "electricRangeMax": { "title": "Electric range up to (km)", "minimum": 0, "maximum": 9999, "type": "integer", "description": "Longest electric range in km." }, "previousOwnersMax": { "title": "Previous owners, at most", "minimum": 1, "maximum": 4, "type": "integer", "description": "At most 1, 2 or 3 previous owners (4 means 4 or more, as on the site)." }, "onlineWithinDays": { "title": "Online within days", "minimum": 1, "maximum": 14, "type": "integer", "description": "Ads online for at most this many days, as AutoScout24 filters them: 1 to 7, or 14." }, "emissionClassMin": { "title": "Emission class, at least", "enum": [ "any", "euro1", "euro2", "euro3", "euro4", "euro5", "euro6", "euro6b", "euro6c", "euro6d_temp", "euro6d", "euro6e" ], "type": "string", "description": "The lowest emission class." }, "emissionSticker": { "title": "German emission sticker, at least", "enum": [ "any", "red", "yellow", "green", "blue" ], "type": "string", "description": "The lowest German emission sticker." }, "batteryOwnership": { "title": "Battery (electric cars)", "enum": [ "any", "included", "rented", "excluded" ], "type": "string", "description": "Whether the battery is included in the price." }, "damagedCars": { "title": "Damaged cars", "enum": [ "exclude", "include", "only" ], "type": "string", "description": "Damaged cars are left out by default, as on the site." }, "onlineSaleAds": { "title": "Online sale ads", "enum": [ "include", "exclude", "only" ], "type": "string", "description": "Ads sold through AutoScout24's own online shop. Their details are not read (their pages are in robots.txt), so with details on they are delivered with the search data only." }, "vatDeductibleOnly": { "title": "VAT deductible only", "type": "boolean", "description": "Only cars whose price lets a business buyer deduct VAT." }, "leasingOnly": { "title": "Leasing offers only", "type": "boolean", "description": "Only cars with a leasing offer." }, "priceReducedOnly": { "title": "Price reduced only", "type": "boolean", "description": "Only \"super deal\" cars whose price was reduced." }, "newDriverSuitableOnly": { "title": "Suitable for new drivers only", "type": "boolean", "description": "Only cars AutoScout24 marks as suitable for new drivers." }, "filters": { "title": "Other AutoScout24 filters", "type": "object", "description": "Any other filter of the site, by its own parameter name and value, such as {\"lsavno\": true, \"wbfrom\": 3000, \"sout\": [\"2\"]}. A name this Actor does not know refuses the run (the site would ignore it and search wider)." }, "includeKeywords": { "title": "Must contain one of these words", "type": "array", "description": "Whole words looked for in the title, version and subtitle (and the description and equipment when details are read). A row needs one of them.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain these words", "type": "array", "description": "Whole words that leave a row out, looked for where the words above are.", "items": { "type": "string" } }, "customFilters": { "title": "Custom filters", "type": "array", "description": "Rules on any output field, all of which must hold: [{\"field\": \"powerHp\", \"op\": \"gte\", \"value\": 150}, {\"field\": \"city\", \"op\": \"notEquals\", \"value\": \"Berlin\"}]. Ops: includes, notIncludes, equals, notEquals, gt, gte, lt, lte." }, "excludeAdIds": { "title": "Leave out these ads", "type": "array", "description": "Ad ids or links never delivered.", "items": { "type": "string" } }, "postedWithinHours": { "title": "Online within hours", "minimum": 1, "maximum": 720, "type": "integer", "description": "Only ads that went online within this many hours of the run's start (needs details on; the date is on the details)." }, "postedWithinDays": { "title": "Online within days (exact)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only ads that went online within this many days of the run's start (needs details on)." }, "postedAfter": { "title": "Online on or after (date)", "type": "string", "description": "Only ads that went online on or after this day, YYYY-MM-DD in UTC (needs details on)." }, "postedBefore": { "title": "Online before or on (date)", "type": "string", "description": "Only ads that went online on or before this day, YYYY-MM-DD in UTC (needs details on)." }, "sort": { "title": "Sort", "enum": [ "newest", "oldest", "price_low", "price_high", "mileage_low", "mileage_high", "registration_new", "registration_old", "power_high", "power_low", "best", "distance" ], "type": "string", "description": "The order of every built search. Default: newest first. A search link keeps its own sort." }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 200000, "type": "integer", "description": "The most listing rows the run delivers (searches, links and updates together). Default 100." }, "maxItemsPerSearch": { "title": "Maximum listings per search", "minimum": 1, "maximum": 200000, "type": "integer", "description": "The most listing rows one search delivers." }, "maxPagesPerSearch": { "title": "Maximum pages per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most result pages (200 rows each, 20 on a dealer page) one search reads. A monitor reads 3 by default." }, "startPage": { "title": "Start page", "minimum": 1, "maximum": 20, "type": "integer", "description": "The result page each search starts on (not with a monitor)." }, "splitLargeSearches": { "title": "Split large searches by price", "type": "boolean", "description": "On by default: a search with more ads than one walk reaches (about 3,400 of the site's 4,000 row cap) is split into price slices with count calls, so every ad is read. Off for monitors." }, "includeDetails": { "title": "Listing details (add-on)", "type": "boolean", "description": "Read each search row's details: description, full equipment list, previous owners, accident flag, warranty, next inspection, emission class, VAT rate and net price, HSN/TSN where shown, history report link, coordinates, the date the ad went online, and the dealer's rating breakdown and opening hours. Billed as Listing details per row read." }, "includeDealerProfiles": { "title": "Dealer profiles (add-on)", "type": "boolean", "description": "Read each dealer's AutoScout24 page once per run: rating, reviews, imprint with its e-mail address and VAT id, opening hours, contact persons, services, homepage. Billed as Dealer profile once per dealer." }, "maxDealerReviews": { "title": "Dealer reviews per profile", "minimum": 0, "maximum": 50, "type": "integer", "description": "The most reviews a dealer profile carries (those the dealer page shows). Default 10." }, "includePersonalData": { "title": "Include private sellers' personal data", "type": "boolean", "description": "Off by default. On: private sellers' phone numbers and WhatsApp numbers as AutoScout24 shows them, their exact coordinates, and phone numbers and e-mail addresses inside their own texts (off, those are removed and coordinates rounded to about 1 km). Dealers' contact details are business data and always delivered. You are responsible for a lawful use, GDPR included." }, "currency": { "title": "Also show prices in", "enum": [ "EUR", "USD", "GBP", "CHF", "PLN", "CZK", "SEK", "DKK", "NOK", "HUF", "RON", "BGN", "TRY", "JPY", "CAD", "AUD" ], "type": "string", "description": "Prices stay in euros; another currency adds a converted price at the European Central Bank's rate of the day." }, "imageSize": { "title": "Image size", "enum": [ "small", "medium", "large" ], "type": "string", "description": "The size of the image links. Default large." }, "descriptionFormat": { "title": "Description format", "enum": [ "text", "html", "markdown", "all" ], "type": "string", "description": "The format of the description (rows with details)." }, "descriptionMaxLength": { "title": "Description length, at most", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Cut descriptions to this many characters." }, "compactOutput": { "title": "Compact rows", "type": "boolean", "description": "Only the core fields on each row (what a row paid for stays)." }, "excludeEmptyFields": { "title": "Leave out empty fields", "type": "boolean", "description": "Drop fields that are empty on a row." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "A short name (\"golf-de\"). The monitor remembers every ad it delivered; known ads are free. One name holds one set of settings." }, "trackChanges": { "title": "Track changes", "type": "boolean", "description": "Also deliver known ads whose price (or a tracked field) changed or that came back, and ads that left every search (removed), billed as Listing update." }, "trackFields": { "title": "Tracked fields", "type": "array", "description": "The fields whose change makes a Listing update. Default: price.", "items": { "type": "string", "enum": [ "price", "mileageKm", "title", "version", "firstRegistration", "powerKw", "fuel", "gearbox", "priceRating", "imageCount" ], "enumTitles": [ "Price", "Mileage", "Title", "Version text", "First registration", "Power", "Fuel", "Gearbox", "Price rating", "Number of images" ] } }, "emitUnchanged": { "title": "Deliver unchanged ads too", "type": "boolean", "description": "Deliver known ads without a change as well (billed as Listing), each marked unchanged." }, "markReposts": { "title": "Mark reposts", "type": "boolean", "description": "Mark a new ad whose car the monitor delivered under another id (same seller, make, model, registration, mileage and power)." }, "skipReposts": { "title": "Skip reposts", "type": "boolean", "description": "Leave such reposts out (free)." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Rows are POSTed here in batches of 100 (JSON)." }, "webhookSecret": { "title": "Webhook secret", "type": "string", "description": "Signs each batch (HMAC SHA-256, header X-Signature-Sha256)." }, "webhookHeaders": { "title": "Webhook headers", "type": "object", "description": "Extra headers, such as {\"Authorization\": \"Bearer ...\"}." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "The token BotFather gave your bot." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Your chat id, or a channel name starting with @." }, "slackWebhookUrl": { "title": "Slack webhook URL", "type": "string", "description": "An incoming webhook of your Slack workspace." }, "discordWebhookUrl": { "title": "Discord webhook URL", "type": "string", "description": "A webhook of your Discord channel." }, "whatsappAccessToken": { "title": "WhatsApp Cloud API token", "type": "string", "description": "Your WhatsApp Cloud API token." }, "whatsappPhoneNumberId": { "title": "WhatsApp phone number id", "type": "string", "description": "The id of your WhatsApp Cloud API number." }, "whatsappTo": { "title": "WhatsApp recipient", "type": "string", "description": "The number to message, international form without +." }, "notificationLimit": { "title": "Listings per message", "minimum": 1, "maximum": 30, "type": "integer", "description": "The most listings named in each chat message. Default 10." }, "notifyOnlyChanges": { "title": "Notify only new and changed", "type": "boolean", "description": "With a monitor, leave unchanged ads out of the messages (default on)." }, "failIfIncomplete": { "title": "Fail the run when something was not read", "type": "boolean", "description": "Mark the run failed when a search or ad link was not read completely (the rows stay delivered)." }, "maxFailedRequestsPercent": { "title": "Fail the run above this share of failed reads (percent)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Mark the run failed when more than this share of its pages and ad reads failed (the rows stay delivered)." }, "requestsPerSecond": { "title": "Requests per second", "minimum": 0.5, "maximum": 4, "type": "number", "description": "The pace of requests to AutoScout24 (default 3)." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxy (the default: AutoScout24 answers it and its traffic is not billed to you), or your own proxy links." } } }, "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 } } } } } } } } } }