{ "openapi": "3.0.1", "info": { "title": "Marktplaats 2dehands AutoScout24 Car Listing Scraper", "description": "Scrape used car listings from Marktplaats, 2dehands, and AutoScout24. Filter by brand, model, price, year, mileage, fuel, and location. Export JSON/CSV or use the Apify API — built for dealers, brokers, agencies, and market research in NL/BE.", "version": "0.0", "x-build-id": "8iBOPz61x3WG80UEL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/market_flow~Car-LIsting-Scraper-Apify/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-market_flow-Car-LIsting-Scraper-Apify", "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/market_flow~Car-LIsting-Scraper-Apify/runs": { "post": { "operationId": "runs-sync-market_flow-Car-LIsting-Scraper-Apify", "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/market_flow~Car-LIsting-Scraper-Apify/run-sync": { "post": { "operationId": "run-sync-market_flow-Car-LIsting-Scraper-Apify", "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": { "action": { "title": "What do you want to do?", "enum": [ "scrape", "list_brands", "list_models" ], "type": "string", "description": "Find car listings, or run a catalog call to list brands / models (helpful before you scrape).", "default": "scrape" }, "catalog_source": { "title": "Brand/model catalog from", "enum": [ "lrp", "as24", "both" ], "type": "string", "description": "Only for List brands / List models. Where to load names from.", "default": "lrp" }, "sites": { "title": "Websites", "type": "array", "description": "Which sites to search. Marktplaats is Netherlands, 2dehands is Belgium, AutoScout24 covers several countries.", "items": { "type": "string", "enum": [ "marktplaats", "2dehands", "autoscout24" ] }, "default": [ "marktplaats", "2dehands", "autoscout24" ] }, "vehicle_type": { "title": "Vehicle type", "enum": [ "cars", "vans", "trucks" ], "type": "string", "description": "Cars, vans, or trucks.", "default": "cars" }, "brand_slug": { "title": "Brand", "enum": [ "", "abarth", "aiways", "aixam", "alfa-romeo", "alpina", "alpine", "aston-martin", "audi", "austin", "bentley", "bmw", "bugatti", "buick", "byd", "cadillac", "chevrolet", "chrysler", "citroen", "cupra", "dacia", "daewoo", "daihatsu", "dodge", "dongfeng", "donkervoort", "ds", "ferrari", "fiat", "fisker", "ford", "ford-usa", "genesis", "gmc", "honda", "hongqi", "hummer", "hyundai", "infiniti", "isuzu", "jaguar", "jeep", "kia", "lada", "lamborghini", "lancia", "land-rover", "landwind", "leapmotor", "lexus", "lincoln", "lotus", "lucid", "lynk-co", "maserati", "mazda", "mclaren", "mercedes-benz", "mercury", "mg", "mini", "mitsubishi", "nio", "nissan", "oldsmobile", "oldtimers", "opel", "overige-auto-s", "peugeot", "polestar", "pontiac", "porsche", "renault", "rolls-royce", "rover", "saab", "seat", "seres", "skoda", "smart", "spyker", "ssangyong", "subaru", "suzuki", "tesla", "toyota", "triumph", "vinfast", "volkswagen", "volvo", "voyah", "xpeng", "zeekr" ], "type": "string", "description": "Pick a car brand, or Any brand.", "default": "" }, "models": { "title": "Models", "type": "array", "description": "Pick one or more models. You can also type a model name if it is missing. Leave empty for any model.", "items": { "type": "string", "enumSuggestedValues": [ "1-Serie", "100", "1007", "106", "107", "108", "2-Serie", "2-Serie Active Tourer", "2-Serie Gran Coupé", "2-Serie Gran Tourer", "200", "2008", "205", "206", "206+", "207", "208", "3-Serie", "3-Serie GT", "3008", "306", "307", "308", "309", "4-Serie", "4-Serie Gran Coupé", "4007", "405", "406", "407", "408", "5-Serie", "5-Serie GT", "5008", "508", "6-Serie", "6-Serie Gran Coupé", "605", "607", "7-Serie", "8-Serie", "8-Serie Gran Coupé", "80", "806", "807", "90", "A1", "A2", "A3", "A4", "A5", "A6", "A7", "A8", "ADAM", "Agila", "Amarok", "Ampera", "Ampera-e", "Antara", "Arteon", "Ascona", "Astra", "Auris", "Avensis", "Avensis Verso", "Aygo", "Aygo X", "B-Max", "Beetle (Kever)", "Bipper", "Bora", "Boxer", "bZ4X", "C-HR", "C-Max", "Cabrio", "Caddy Combi", "Caddy Maxi", "Calibra", "Camry", "Carina", "Cascada", "Celica", "Combo Tour", "Corolla", "Corolla Cross", "Corolla TS", "Corolla Verso", "Corrado", "Corsa", "Corsa-e", "Cougar", "Coupe", "Crossland X", "E-Rifter", "e-tron", "e-tron GT", "Ecosport", "Edge", "Eos", "Escort", "Expert Combi", "Explorer", "Fiësta", "Focus", "Fox", "Frontera", "Fusion", "Galaxy", "Golf", "Golf Plus", "Golf Sportsvan", "Golf Variant", "GR86", "Grand C-Max", "Grandland", "Grandland X", "GT", "GT86", "Highlander", "Hilux", "i3", "i4", "i5", "i7", "i8", "ID.3", "ID.4", "ID.5", "ID.7", "ID.Buzz", "Insignia", "iOn", "IQ", "iX", "iX1", "iX2", "iX3", "Jetta", "Ka", "Kadett", "Karl", "Kuga", "Land Cruiser V8", "Landcruiser", "Lupo", "Manta", "Meriva", "Mirai", "Mokka", "Mokka-e", "MokkaX", "Mondeo", "Movano", "MR2", "Multivan", "Mustang", "Omega", "Partner", "Partner Tepee", "Paseo", "Passat", "Passat CC", "Phaeton", "Picnic", "Polo", "Previa", "Prius", "Prius Wagon", "ProAce", "ProAce City", "Probe", "Puma", "Q2", "Q3", "Q4 e-tron", "Q5", "Q6 e-tron", "Q7", "Q8", "Q8 e-tron", "Quattro", "R8", "Ranger", "Rav4", "RCZ", "Rifter", "RS2", "RS3", "RS4", "RS5", "RS6", "RS7", "RSQ3", "RSQ8", "S-Max", "S1", "S2", "S3", "S4", "S5", "S6", "S7", "S8", "Scirocco", "Scorpio", "Senator", "Sharan", "Sierra", "Signum", "Sintra", "Speedster", "SQ2", "SQ5", "SQ7", "SQ8", "Starlet", "Supra", "T-Cross", "T-Roc", "Taigo", "Tayron", "Tigra", "Tiguan", "Touareg", "Touran", "Tourneo Connect", "Tourneo Courier", "Transit", "Transporter", "Traveller", "TT", "Tundra", "up!", "Urban Cruiser", "V8", "Vectra", "Vento", "Verso", "Verso-S", "Vivaro", "X1", "X2", "X3", "X4", "X5", "X6", "X7", "XL1", "XM", "Yaris", "Yaris Cross", "Yaris Verso", "Z1", "Z3", "Z4", "Z8", "Zafira" ] } }, "body_type_ids": { "title": "Body types", "type": "array", "description": "Body styles to include. Works on Marktplaats, 2dehands, and AutoScout24. You can pick more than one.", "items": { "type": "string", "enum": [ "Hatchback", "SUV", "Stationwagon", "Sedan", "MPV", "Cabriolet", "Coupe", "Other" ] } }, "fuel_type_ids": { "title": "Fuel", "type": "array", "description": "Fuel types to include. You can pick more than one.", "items": { "type": "string", "enum": [ "Petrol", "Diesel", "Electric", "Hybrid Petrol", "Hybrid Diesel", "LPG", "CNG", "Hydrogen", "Other" ] } }, "transmission_id": { "title": "Gearbox", "enum": [ "Any", "Automatic", "Manual" ], "type": "string", "description": "Automatic, manual, or any gearbox.", "default": "Any" }, "doors": { "title": "Doors", "enum": [ "Any", "2-or-3", "4-or-5", "6-plus" ], "type": "string", "description": "How many doors the car should have.", "default": "Any" }, "price_min_eur": { "title": "Minimum price (€)", "type": "integer", "description": "Only show cars at this price or higher." }, "price_max_eur": { "title": "Maximum price (€)", "type": "integer", "description": "Only show cars at this price or lower." }, "year_min": { "title": "From year", "type": "integer", "description": "Oldest year you want (for example 2015)." }, "year_max": { "title": "To year", "type": "integer", "description": "Newest year you want (for example 2020)." }, "mileage_min_km": { "title": "Minimum mileage (km)", "type": "integer", "description": "Only show cars with at least this many kilometres." }, "mileage_max_km": { "title": "Maximum mileage (km)", "type": "integer", "description": "Only show cars with at most this many kilometres." }, "as24_country_code": { "title": "AutoScout24 country", "enum": [ "Netherlands", "Belgium", "Germany", "France", "Italy", "Luxembourg", "Spain", "Austria", "Europe" ], "type": "string", "description": "Country for AutoScout24 only. Does not change Marktplaats or 2dehands.", "default": "Netherlands" }, "zip": { "title": "Postcode", "type": "string", "description": "Search near this postcode. On Marktplaats and 2dehands you also need a distance." }, "radius_km": { "title": "Distance (km)", "minimum": 1, "maximum": 400, "type": "integer", "description": "How far from the postcode to search. Typical values: 10, 20, 50, 100, 150, 200, 250, 300, 400." }, "max_pages": { "title": "How many pages to load", "minimum": 1, "type": "integer", "description": "More pages means more results, but the run takes longer. Usually 1–5 is enough.", "default": 5 }, "enrich_output": { "title": "Add extra details from each ad", "type": "boolean", "description": "Opens each listing’s detail page for more info (full description, seller type, doors, and similar). Makes the run slower and costs extra per enriched listing (pay-per-event: listing-enriched).", "default": false }, "split_output_by_site": { "title": "Separate results by website", "type": "boolean", "description": "Also save Marktplaats, 2dehands, and AutoScout24 results in their own groups. Useful if you want to download one site at a time.", "default": false }, "today_only": { "title": "Today’s ads only", "type": "boolean", "description": "Not available yet. Turning this on does nothing for now.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }