Plugins

Scrape Leboncoin search

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.

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

Query parameters

querystring required

What to search, e.g. 'velo electrique' or 'iphone 13'.

categorystring 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.

locationstring nullable

Where to search: a city ('Bordeaux'), a city with postcode ('Toulouse 31000'), a department code ('75') or a region ('Ile-de-France').

min_priceinteger nullable

Lowest price to include (EUR).

max_priceinteger nullable

Highest price to include (EUR).

sortstring

Ordering: relevance, newest, price_low, price_high.

max_resultsinteger

How many listings to collect across pages.

pageinteger

1-based page to start from (35 per page).

proxy_countrystring nullable

Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Optional.

include_sponsoredboolean

Also return Leboncoin's paid 'a la une' placements (sponsored: true). Off by default: they ignore the query, category and sort.

Response

JSON with a listings array plus totalResults.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.