{ "openapi": "3.0.1", "info": { "title": "Leboncoin Universal Scraper - Vehicles", "description": "⚡ Scrape unlimited Leboncoin vehicle listings — no URL needed! Choose cars, motorbikes or vans, add your filters (brand, fuel, gearbox, mileage, year, price…) and instantly get rich, structured data for market analysis, deal sourcing, price monitoring or lead generation.", "version": "0.1", "x-build-id": "LWnxvyj41nYO5ADXE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapifier~leboncoin-universal-scraper-vehicles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapifier-leboncoin-universal-scraper-vehicles", "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/scrapifier~leboncoin-universal-scraper-vehicles/runs": { "post": { "operationId": "runs-sync-scrapifier-leboncoin-universal-scraper-vehicles", "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/scrapifier~leboncoin-universal-scraper-vehicles/run-sync": { "post": { "operationId": "run-sync-scrapifier-leboncoin-universal-scraper-vehicles", "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": { "category": { "title": "Vehicle type", "enum": [ "2", "3", "5", "4", "300", "7" ], "type": "string", "description": "Which vehicle category to search. Car filters apply to cars/vans; motorbike filters (engine cc, type, licence) apply to motorbikes.", "default": "2" }, "text": { "title": "Keywords", "type": "string", "description": "Optional free-text keywords, e.g. a model or trim." }, "locations": { "title": "Location(s)", "type": "array", "description": "City, arrondissement or postal code, e.g. \"Paris 11\", \"Lyon\", \"75011\". Add several, or leave empty to search all of France.", "items": { "type": "string" } }, "vehicle_brand": { "title": "Brand", "type": "string", "description": "Brand in UPPERCASE, e.g. RENAULT, PEUGEOT, BMW, YAMAHA, HONDA." }, "vehicle_model": { "title": "Model", "type": "string", "description": "Model as BRAND_Model, e.g. RENAULT_Clio, PEUGEOT_208, BMW_Serie 3." }, "fuel": { "title": "Fuel", "type": "array", "description": "One or more fuel types.", "items": { "type": "string", "enum": [ "1", "2", "4", "6", "8" ], "enumTitles": [ "Petrol", "Diesel", "Electric", "Hybrid", "Plug-in hybrid" ] } }, "gearbox": { "title": "Gearbox", "type": "array", "description": "Manual and/or automatic.", "items": { "type": "string", "enum": [ "1", "2" ], "enumTitles": [ "Manual", "Automatic" ] } }, "year_min": { "title": "Min year", "minimum": 1900, "type": "integer", "description": "Minimum registration year." }, "year_max": { "title": "Max year", "minimum": 1900, "type": "integer", "description": "Maximum registration year." }, "mileage_min": { "title": "Min mileage (km)", "minimum": 0, "type": "integer", "description": "Minimum mileage." }, "mileage_max": { "title": "Max mileage (km)", "minimum": 0, "type": "integer", "description": "Maximum mileage." }, "price_min": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price." }, "price_max": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price." }, "owner_type": { "title": "Seller type", "enum": [ "all", "private", "pro" ], "type": "string", "description": "Filter by seller.", "default": "all" }, "sort": { "title": "Sort by", "enum": [ "relevance", "newest", "price_asc", "price_desc" ], "type": "string", "description": "Result ordering.", "default": "relevance" }, "vehicle_type": { "title": "Body type (cars)", "type": "array", "description": "Car body type.", "items": { "type": "string", "enum": [ "citadine", "berline", "break", "coupe", "cabriolet", "monospace", "4x4", "autre" ], "enumTitles": [ "City car", "Sedan", "Estate", "Coupé", "Convertible", "Minivan", "SUV / 4x4", "Other" ] } }, "vehicle_color": { "title": "Colour", "type": "array", "description": "Vehicle colour.", "items": { "type": "string", "enum": [ "blanc", "noir", "gris", "bleu", "rouge", "vert", "marron", "beige", "argent", "orange", "bordeaux", "jaune", "violet", "autre" ], "enumTitles": [ "White", "Black", "Grey", "Blue", "Red", "Green", "Brown", "Beige", "Silver", "Orange", "Burgundy", "Yellow", "Purple", "Other" ] } }, "doors_min": { "title": "Min doors", "minimum": 2, "type": "integer", "description": "Minimum number of doors." }, "seats_min": { "title": "Min seats", "minimum": 1, "type": "integer", "description": "Minimum number of seats." }, "power_min": { "title": "Min power (hp / ch DIN)", "minimum": 0, "type": "integer", "description": "Minimum DIN horsepower." }, "critair_max": { "title": "Max Crit'Air", "minimum": 0, "maximum": 5, "type": "integer", "description": "Maximum Crit'Air rating (0 = cleanest, e.g. electric)." }, "euro_standard": { "title": "Euro emission standard", "type": "array", "description": "Emission standard.", "items": { "type": "string", "enum": [ "euro2", "euro3", "euro4", "euro5", "euro5plus", "euro6" ], "enumTitles": [ "Euro 2", "Euro 3", "Euro 4", "Euro 5", "Euro 5+", "Euro 6" ] } }, "vsp": { "title": "Licence (cars)", "type": "array", "description": "With or without driving licence.", "items": { "type": "string", "enum": [ "avecpermis", "sanspermis" ], "enumTitles": [ "Licence required", "No licence (VSP)" ] } }, "vehicle_condition": { "title": "Condition", "type": "array", "description": "Vehicle condition.", "items": { "type": "string", "enum": [ "excellent_condition", "good_overall_condition", "minor_repairs_needed", "major_repairs_needed", "undamaged", "normal_wear_and_tear" ], "enumTitles": [ "Excellent", "Good overall", "Minor repairs needed", "Major repairs needed", "Undamaged", "Normal wear" ] } }, "cc_min": { "title": "Min engine (cm³)", "minimum": 0, "type": "integer", "description": "Minimum engine displacement (motorbikes)." }, "cc_max": { "title": "Max engine (cm³)", "minimum": 0, "type": "integer", "description": "Maximum engine displacement (motorbikes)." }, "cycle_type": { "title": "Type", "type": "array", "description": "Two-wheeler type.", "items": { "type": "string", "enum": [ "moto", "scooter", "moped&motorbike" ], "enumTitles": [ "Motorcycle", "Scooter", "Moped" ] } }, "motorcycle_type": { "title": "Style", "type": "array", "description": "Motorcycle style.", "items": { "type": "string", "enum": [ "sportive", "motocross", "supermotard", "trail", "roadster", "touring", "enduro" ], "enumTitles": [ "Sport", "Motocross", "Supermoto", "Trail", "Roadster", "Touring", "Enduro" ] } }, "cycle_licence": { "title": "Licence", "type": "array", "description": "Required licence (motorbikes).", "items": { "type": "string", "enum": [ "permisam", "permisa2", "permisa", "permisal", "sanspermis" ], "enumTitles": [ "AM", "A2", "A", "AL", "No licence" ] } }, "filters": { "title": "Advanced filters", "type": "object", "description": "Any other Leboncoin vehicle filter — each entry is a key with either a list of codes (enum) or a {\"min\":.., \"max\":..} range. Example: {\"u_car_model\": [\"RENAULT_Clio\"], \"horsepower\": {\"min\": 4, \"max\": 7}, \"vehicule_color\": [\"noir\", \"gris\"]}. The full key/code tables are in the README (Filters reference section). Tip: build your search on leboncoin.fr and copy the URL query parameters — every key and value from the URL works here (e.g. fuel=2&gearbox=2&mileage=0-100000 → {\"fuel\": [\"2\"], \"gearbox\": [\"2\"], \"mileage\": {\"max\": 100000}}). Also lets you override any dedicated input above." }, "max_results": { "title": "Max results", "minimum": 0, "type": "integer", "description": "How many listings to collect (0 = as many as available).", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Residential FR proxies are recommended for reliable runs." } } }, "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 } } } } } } } } } }