{
"openapi": "3.0.1",
"info": {
"title": "Leboncoin Scraper | Classified Ads, Prices and Sellers",
"description": "Leboncoin scraper for France's largest classifieds site. Extract titles, prices, cities, categories, photos and seller phone numbers from real estate, cars, jobs and more. Search by keyword, search URL or ad ID. 1000 ads in 75 seconds, 15 fields each, no account needed. Export CSV, JSON or Excel.",
"version": "1.0",
"x-build-id": "khqHJ5i89DjUufDbo"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~leboncoin-scraper-ppr/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-leboncoin-scraper-ppr",
"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/silentflow~leboncoin-scraper-ppr/runs": {
"post": {
"operationId": "runs-sync-silentflow-leboncoin-scraper-ppr",
"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/silentflow~leboncoin-scraper-ppr/run-sync": {
"post": {
"operationId": "run-sync-silentflow-leboncoin-scraper-ppr",
"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": "🔎 Keywords",
"type": "array",
"description": "Words to search, as you would type them on leboncoin.fr (e.g. appartement, peugeot 208). Add several keywords to cover them all in one run: they share the Max Results, and an ad matching two keywords is returned once. Ignored when a Search URL or Ad IDs are provided.",
"items": {
"type": "string"
}
},
"searchUrl": {
"title": "🔗 Search URL",
"type": "string",
"description": "Paste a Leboncoin search URL with all your filters already applied. Go to leboncoin.fr, set your keywords, category, location, price range, then copy the URL from your browser. All filters from the URL are used automatically, and the keywords are ignored."
},
"adIds": {
"title": "🆔 Ad IDs or links",
"type": "array",
"description": "Leboncoin ad IDs (e.g. 3009018573) or ad links (e.g. https://www.leboncoin.fr/ad/voitures/3009018573). Each ad comes back with its full details: description, seller, GPS coordinates and attributes. When filled, the keywords and the Search URL are ignored.",
"items": {
"type": "string"
}
},
"text": {
"title": "Search Text",
"type": "string",
"description": "One more keyword, searched along with the Keywords list above (e.g. appartement, voiture, iphone). Ignored when a Search URL or Ad IDs are provided."
},
"category": {
"title": "Category",
"enum": [
"0",
"8",
"9",
"10",
"11",
"2",
"3",
"1",
"71",
"72",
"24"
],
"type": "string",
"description": "Leboncoin category to search in.",
"default": "0"
},
"ownerType": {
"title": "Seller Type",
"enum": [
"all",
"private",
"pro"
],
"type": "string",
"description": "Filter by seller type.",
"default": "all"
},
"maxItems": {
"title": "Max Results",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of ads to return, shared across all keywords. You pay per result.",
"default": 1000
},
"browseMode": {
"title": "Full Details (Browse Mode)",
"type": "boolean",
"description": "Visit each ad's detail page for full data: description, phone number, seller info, GPS coordinates, and attributes. Slower but much richer data. Ads fetched by ID always come with full details.",
"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
},
"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
}
}
}
}
}
}
}
}
}
}