{ "openapi": "3.0.1", "info": { "title": "Leboncoin Scraper", "description": "Scrape leboncoin.fr classifieds: real estate, cars, jobs and more. Get price, surface, rooms, GPS, images, seller type and all attributes as structured JSON, ready for Sheets or your CRM. Filters by location, price, rooms and seller. Uses the app's JSON API, no browser. Pay per result.", "version": "1.0", "x-build-id": "aI1DhQL30b10mXKC6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~leboncoin-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-leboncoin-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/axlymxp~leboncoin-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-leboncoin-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/axlymxp~leboncoin-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-leboncoin-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", "required": [ "category" ], "properties": { "category": { "title": "Category", "enum": [ "9", "10", "11", "13", "12", "8", "2", "3", "1", "0" ], "type": "string", "description": "Leboncoin category id to search. Real estate: 9 = sales, 10 = rentals, 11 = flat-shares, 13 = offices/shops, 12 = seasonal. Others: 2 = cars, 3 = motorbikes, 1 = vehicles, 8 = real estate (all).", "default": "9" }, "keywords": { "title": "Keywords", "type": "string", "description": "Optional free-text query (e.g. 'appartement terrasse')." }, "departmentIds": { "title": "Department IDs", "type": "array", "description": "Filter by French department numbers, e.g. [\"75\", \"92\"] for Paris & Hauts-de-Seine.", "items": { "type": "string" } }, "regionIds": { "title": "Region IDs", "type": "array", "description": "Filter by region ids, e.g. [\"12\"] for Île-de-France.", "items": { "type": "string" } }, "geo": { "title": "Geo radius", "type": "object", "description": "Radius search around a point: { \"lat\": 48.8566, \"lng\": 2.3522, \"radiusKm\": 10 }." }, "realEstateTypes": { "title": "Real-estate types", "type": "array", "description": "Property types (real-estate categories only).", "items": { "type": "string", "enum": [ "maison", "appartement", "terrain", "parking", "autre" ], "enumTitles": [ "House", "Apartment", "Land", "Parking/Box", "Other" ] } }, "priceMin": { "title": "Min price (€)", "minimum": 0, "type": "integer", "description": "Minimum price in euros." }, "priceMax": { "title": "Max price (€)", "minimum": 0, "type": "integer", "description": "Maximum price in euros." }, "squareMin": { "title": "Min surface (m²)", "minimum": 0, "type": "integer", "description": "Minimum living surface in m²." }, "squareMax": { "title": "Max surface (m²)", "minimum": 0, "type": "integer", "description": "Maximum living surface in m²." }, "roomsMin": { "title": "Min rooms", "minimum": 0, "type": "integer", "description": "Minimum number of rooms." }, "roomsMax": { "title": "Max rooms", "minimum": 0, "type": "integer", "description": "Maximum number of rooms." }, "ownerType": { "title": "Seller type", "enum": [ "all", "private", "pro" ], "type": "string", "description": "Filter by seller type.", "default": "all" }, "sortBy": { "title": "Sort by", "enum": [ "time", "relevance", "price" ], "type": "string", "description": "Field to sort results by.", "default": "time" }, "sortOrder": { "title": "Sort order", "enum": [ "desc", "asc" ], "type": "string", "description": "Ascending or descending order.", "default": "desc" }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Also fetch each ad's full detail payload (slower, more API calls).", "default": false }, "maxItems": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Stop after this many listings.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leboncoin blocks datacenter IPs. Default is Apify RESIDENTIAL from France; each DataDome challenge rotates to a new exit automatically (proxy traffic is billed to your plan).", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "FR" } } } }, "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 } } } } } } } } } }