Search Leboncoin ads
Input
page optionalPage index (capped at max_pages=100).
Default: 1text optionalFree-text query, e.g. 'iphone 13' or 'table en chêne'.
locations optionalCity name or comma-separated cities, e.g. 'Paris' or 'Paris,Lyon'.
Output
ads requiredcount requiredtotal requiredmax_pages requiredFAQ
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 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.
Get Leboncoin seller profile
Fetch a Leboncoin seller's public profile by its URL (as returned by get_ad's seller_profile_url). Works for both professional stores and private-individual sellers, returning a unified shape: name, member-since date, total ad count, response rate/time, presence, badges, and description. Pro sellers additionally get address, opening hours, website, and an aggregated rating with sample reviews — these are null for private sellers, who have no storefront or public rating on the site.