Create a leboncoin classified ad
Input
photo requiredThe ad photo (PNG or JPEG). leboncoin refuses to publish an ad with no photo.
price requiredAsking price in euros.
title requiredAd title. leboncoin derives the category suggestions from this, so it must describe the item (e.g. "Vélo de ville adulte").
lastName requiredSeller last name, required by the form.
location requiredStreet address to advertise from, e.g. "12 rue Duphot Paris". Resolved against leboncoin's own address suggestions; the first suggestion is taken and returned in resolvedLocation.
firstName requiredSeller first name, required by the form.
description requiredAd body text.
dryRun optionalTrue (default) fills and validates the whole form, including resolving the address, reports what would be posted, and stops before submitting, so no ad is created. Set false to actually publish (free option only). The boost and free-option steps after submitting only run on a real publish.
Default: trueOutput
title requireddryRun requiredpublished requiredTrue only when the confirmation screen was reached. False on a dry run.
categoryChosen requiredThe category leboncoin suggested for this title and the script selected.
resolvedLocation requiredThe address as leboncoin resolved it from its own suggestions, e.g. "12 Rue Duphot, Paris (75001)".
price optionalconfirmationText optionalThe confirmation screen's message when published; null on a dry run. A newly posted ad sits at "En cours de vérification" until leboncoin reviews it.
FAQ
Get Leboncoin ad
Fetch a single Leboncoin classified ad by its URL. Returns title, full description, price, seller info, location, favorites count, all images, and a generic list of the ad's own category-specific attributes (e.g. mileage/fuel for a car, rooms/surface for a real estate listing, condition/material for furniture) with their labels and values as leboncoin itself displays them. Works across every category since the attribute list is read generically rather than assuming a fixed schema per category.
Search Leboncoin ads
Search Leboncoin classifieds by keyword and/or location. Returns total, max_pages, count, and ads (each with id, url, title, price_eur, currency, city, zipcode, category_id, category_name, seller_type, published_at, thumb_url, image_count). Paging is capped at max_pages=100.
Search leboncoin jobs
Search leboncoin's "Offres d'emploi" (job listings) category by free-text keyword and optional free-text city location. Reads the search page's own richer underlying data rather than the visible cards, so results include salary, contract type, sector, experience, study level, and work time when the poster provided them (fields are null otherwise, which is common for private-seller ads with no company attached). Location text is matched against leboncoin's own city list, picking the closest whole-city match; an unrecognized location throws. Pagination is 1-based, 35 results per page. An unmatched keyword returns a clean empty result rather than an error. One known limitation: requesting a page beyond the search's real page count is detected and reported as an explicit out-of-range error, rather than the misleading empty result leboncoin's own site would otherwise show.