{ "openapi": "3.0.1", "info": { "title": "Leboncoin Listings Scraper", "description": "Leboncoin Listings Scraper scrapes listings from leboncoin.fr search results, capturing titles, prices, images, location, seller info, category attributes, and optional full details — ideal for price tracking, market research, and competitive analysis of France's largest classifieds marketplace.", "version": "0.0", "x-build-id": "XZI3S3sauUIW5YJw6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~leboncoin-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-leboncoin-listings-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/piotrv1001~leboncoin-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-leboncoin-listings-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/piotrv1001~leboncoin-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-leboncoin-listings-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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Free-text keywords to search for (e.g. 'iPhone 16', 'vélo électrique'). Multiple queries will run as separate searches. Leave empty to get the newest listings (of the chosen categories, if any).", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Leboncoin search page URLs to scrape directly. Takes precedence over search queries and filters.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Leboncoin category IDs to filter by (e.g. 2 = Voitures, 9 = Ventes immobilières, 15 = Ordinateurs, 17 = Téléphones & Objets connectés, 55 = Vélos). The ID is the category=… value in a leboncoin search URL.", "default": [] }, "locations": { "title": "Locations", "type": "array", "description": "City name ('Paris', 'Le Havre') or 'City_zipcode' for one zipcode/arrondissement ('Paris_75011', 'Bordeaux_33000'). Departments as 'd_75', regions as 'r_12'.", "default": [], "items": { "type": "string" } }, "priceMin": { "title": "Min Price (€)", "minimum": 0, "type": "integer", "description": "Minimum price filter in euros." }, "priceMax": { "title": "Max Price (€)", "minimum": 0, "type": "integer", "description": "Maximum price filter in euros." }, "ownerType": { "title": "Seller Type", "enum": [ "pro", "private" ], "type": "string", "description": "Filter by seller type." }, "shippableOnly": { "title": "Shippable Only", "type": "boolean", "description": "Only return listings that offer shipping.", "default": false }, "sort": { "title": "Sort Order", "enum": [ "time", "price" ], "type": "string", "description": "Sort search results by time (newest first) or price.", "default": "time" }, "includeDetails": { "title": "Include Details", "type": "boolean", "description": "Fetch the full listing description by visiting each detail page. Slower and uses more proxy bandwidth. Charged at the 'item-details' rate instead of 'product-listing'.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited).", "default": 50 }, "maxPages": { "title": "Max Pages per Search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of result pages to scrape per search query. Leboncoin serves 19 pages (about 665 listings) per search; larger searches are split into price ranges automatically, each with its own 19 pages.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies are strongly recommended; leboncoin blocks datacenter IPs after a few requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }