{
"openapi": "3.0.1",
"info": {
"title": "Leboncoin Scraper | Classified Ads, Prices and Sellers",
"description": "Scrape Leboncoin classified ads with pay-per-result pricing. Extract prices, full descriptions, seller phone numbers and GPS coordinates from France's largest marketplace. Covers real estate, cars, jobs, fashion and electronics. Pay only for ads successfully scraped, residential proxies included.",
"version": "1.0",
"x-build-id": "btFlzAbMMJb7uLtFE"
},
"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
}
}
}
}
}
}
}
}
}
}