---
title: "Scrape Leboncoin search"
method: POST
path: "/marketplace/leboncoin-search"
tags: ["Plugins"]
---

# Scrape Leboncoin search

`POST /marketplace/leboncoin-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/marketplace/leboncoin-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches Leboncoin (France) for `query` and returns the ads as JSON: `id`, `title`, `price` and `currency`, `location` (city + postcode), `category`, publication `date`, `image`, listing `url`, `sellerType` (pro/private) and the ad's `attributes`. Narrow with `category`, `location` and `min_price`/`max_price`, order with `sort`, and collect up to `max_results` across pages. Paid 'a la une' placements (`sponsored: true`) are left out unless `include_sponsored=true`.

## Query parameters

- `query` string, required: What to search, e.g. 'velo electrique' or 'iphone 13'.
- `category` string, nullable: Category: vehicles, cars, motorcycles, vans, car_parts, real_estate, real_estate_sale, rentals, flatshare, holiday_rentals, commercial_property, electronics, computers, photo_audio_video, phones, consoles, video_games, computer_accessories, home_garden, furniture, appliances, diy, decoration, garden, fashion, clothing, shoes, bags_accessories, watches_jewelry, baby_equipment, leisure, books, sports, bikes, toys, music_instruments, collectibles, antiques, animals, jobs, job_offers, or a numeric Leboncoin category id.
- `location` string, nullable: Where to search: a city ('Bordeaux'), a city with postcode ('Toulouse 31000'), a department code ('75') or a region ('Ile-de-France').
- `min_price` integer, nullable: Lowest price to include (EUR).
- `max_price` integer, nullable: Highest price to include (EUR).
- `sort` string: Ordering: relevance, newest, price_low, price_high.
- `max_results` integer: How many listings to collect across pages.
- `page` integer: 1-based page to start from (35 per page).
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Optional.
- `include_sponsored` boolean: Also return Leboncoin's paid 'a la une' placements (`sponsored: true`). Off by default: they ignore the query, category and sort.

## Response `200`

JSON with a `listings` array plus `totalResults`.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Leboncoin, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)