leboncoin

Open in ChatGPT →

Overview

Tools Available10

Developerleboncoin

CategoryShopping

toutes les annonces leboncoin!

Available Tools

leboncoin provides 10 tools that can be used to interact with its services.

Search

search

Full Description

Search for ads across all categories on leboncoin.

Use this tool when you don't know the specific category or want to search across multiple categories. All parameters are optional with sensible defaults. Returns ads matching your criteria with basic details like price, location, and category.

Parameters

Optional

category_predictionstring

Predicted category the user is searching for

category_prediction_confidencenumber

Confidence score for the category prediction (0.0 to 1.0)

citystring

City name

departmentstring

Department number (e.g., '75' for Paris)

keywordsstring

Search terms (e.g., 'iphone', 'vélo électrique', 'canapé')

limitnumber

Max results to return (1-100). Default: 10

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

owner_typestring

Seller type. Values: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

sort_bystring

Sort field. Values: 'price', 'date'. Default: 'date'

sort_orderstring

Sort direction. Values: 'asc', 'desc'. Default: 'desc'

zipcodestring

Postal code (e.g., '75001')

Search Cars

search_cars

Full Description

Search for used cars on leboncoin marketplace.

Use this tool to find car listings based on various criteria like brand, price, mileage, and location. Returns a list of car ads with details including price, photos, seller info, and vehicle specifications.

All parameters are optional. Call with no parameters to get recent car listings.

Common use cases:

Find affordable cars: set max_price
Find low-mileage cars: set max_mileage
Find cars near a location: set city or department
Find specific models: set brand and model

Defaults: 10 results, sorted by relevance descending, all seller types.

Parameters

Optional

brandstring

Optional. Car manufacturer. Use vehicles://brands resource to see all available brands.

citystring

Optional. City name to search in (e.g., 'Paris', 'Lyon', 'Marseille'). Default: all France.

colorstring

Optional. Vehicle exterior color. Default: all colors.

Options:argentbeigeblancbleubordeauxgoldengrisivoirejaunemarronnoirorangeroserougevertvioletautre

conditionstring

Optional. Vehicle condition: 'excellent_condition' (near new), 'undamaged', 'good_overall_condition', 'normal_wear_and_tear', 'minor_repairs_needed', 'major_repairs_needed', 'damaged', 'not_drivable'. Default: all.

Options:excellent_conditionundamagedgood_overall_conditionnormal_wear_and_tearminor_repairs_neededmajor_repairs_neededdamagednot_drivable

critairstring

Optional. Crit'Air environmental certificate level (0=electric, 1=best, 5=worst). Default: all levels.

Options:012345

departmentstring

Optional. French department code (e.g., '75' for Paris, '69' for Rhône). Default: all departments.

doorsstring

Optional. Number of doors: '2', '3', '4', '5', '999999' (6+). Default: all.

Options:2345999999

fuelstring

Optional. Fuel type. Default: all fuel types.

Options:dieselpetrolelectrichybridlpg

gearboxstring

Optional. Transmission type. Default: all transmission types.

Options:manualautomatic

keywordsstring

Optional. Search terms to find in car titles and descriptions (e.g., 'sport leather sunroof')

license_requiredstring

Optional. License requirement: 'avecpermis' (requires license), 'sanspermis' (no license required). Default: all.

Options:avecpermissanspermis

limitnumber

Optional. Maximum number of results to return. Default: 10, max: 100.

max_mileagenumber

Optional. Maximum mileage in kilometers (e.g., 100000). Default: no maximum.

max_pricenumber

Optional. Maximum price in euros (e.g., 20000). Default: no maximum.

max_yearnumber

Optional. Maximum registration year (e.g., 2024). Default: no maximum.

min_mileagenumber

Optional. Minimum mileage in kilometers (e.g., 0). Default: no minimum.

min_pricenumber

Optional. Minimum price in euros (e.g., 5000). Default: no minimum.

min_yearnumber

Optional. Minimum registration year (e.g., 2018). Default: no minimum.

modelstring

Optional. Car model name (e.g., 'clio', 'megane', '308', 'golf', 'serie 3'). Works best with brand specified. Use vehicles://cars/brands/{brand}/models resource to see available models for a brand (e.g., vehicles://cars/brands/RENAULT/models).

offsetnumber

Optional. Number of results to skip for pagination. Default: 0.

seatsstring

Optional. Number of seats: '1'-'6', '999999' (7+). Default: all.

Options:123456999999

seller_typestring

Optional. Type of seller. Default: 'all'.

Options:allproprivate

sort_bystring

Optional. Sort results by. Default: 'relevance'.

Options:relevancepricedatemileage

sort_orderstring

Optional. Sort order. Default: 'desc'.

Options:ascdesc

vehicle_typestring

Optional. Vehicle body style: '4x4' (SUV), 'berline' (sedan), 'break' (wagon), 'cabriolet' (convertible), 'citadine' (city car), 'coupe', 'monospace' (minivan), 'voituresociete' (commercial). Default: all types.

Options:4x4berlinebreakcabrioletcitadinecoupemonospacevoituresocieteautre

Search Electronics

search_electronics

Full Description

Search for electronic items (computers, phones, tablets, cameras, gaming, etc.) on leboncoin. Returns ads with details like brand, model, price, location, and seller information.

Parameters

Required

keywordsstring

Search terms (e.g., 'iPhone 13', 'MacBook Pro', 'PS5')

Optional

brandstring

Product brand (e.g., 'Apple', 'Samsung', 'Sony', 'Canon', 'Nintendo')

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

modelstring

Product model name

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

Search Family

search_family

Full Description

Search for family and baby items (baby equipment, children furniture, baby clothes, strollers, toys, etc.) on leboncoin. Returns ads with details like brand, model, baby age category, price, location, and seller information.

Parameters

Required

keywordsstring

Search terms (e.g., 'poussette', 'lit bébé', 'table à langer', 'siège auto')

Optional

baby_agestring

Baby age category (e.g., '0-3 mois', '3-6 mois', '6-12 mois', '12-24 mois', '2-4 ans')

brandstring

Product brand (e.g., 'Babybjörn', 'Chicco', 'Stokke', 'IKEA')

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

Search Fashion

search_fashion

Full Description

Search for fashion items (clothes, shoes, bags, jewelry, watches) on leboncoin. Returns ads with details like brand, size, condition, price, and location.

Parameters

Required

keywordsstring

Search terms (e.g., 'robe Zara', 'Nike Air Max', 'sac Louis Vuitton')

Optional

brandstring

Fashion brand (e.g., 'Zara', 'Nike', 'Adidas', 'H&M', 'Louis Vuitton')

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

Search Home Garden

search_home_garden

Full Description

Search for home and garden items (furniture, appliances, DIY tools, decoration, etc.) on leboncoin. Returns ads with details like brand, model, price, location, and seller information.

Parameters

Required

keywordsstring

Search terms (e.g., 'canapé', 'table IKEA', 'tondeuse')

Optional

brandstring

Product brand (e.g., 'IKEA', 'Bosch', 'Leroy Merlin')

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

modelstring

Product model name

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

Search Leisure

search_leisure

Full Description

Search for leisure and hobby items (books, sports equipment, toys, bikes, music instruments, games, etc.) on leboncoin. Returns ads with details like brand, model, price, location, and seller information.

Parameters

Required

keywordsstring

Search terms (e.g., 'vélo électrique', 'livre cuisine', 'guitare Yamaha', 'ballon foot')

Optional

brandstring

Product brand (e.g., 'Decathlon', 'Yamaha', 'Nintendo', 'Lego')

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

modelstring

Product model name

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

Search Real Estate Renting

search_real_estate_renting

Full Description

Search for real estate properties for rent on leboncoin.

All parameters are optional with sensible defaults. Returns rental properties matching your criteria with details like rent, location, surface area, and amenities.

Parameters

Optional

citystring

City name

departmentstring

Department number (e.g., '75' for Paris)

elevatorarray

Elevator filter. Values: '1' (yes). Default: all

energy_ratearray

DPE energy rating: 'a' (best) to 'g' (worst), 'v'=blank, 'n'=not subject. Default: all

floor_propertyarray

Floor type. Values: 'ground_floor', 'upper_floor', 'last_stage'. Default: all

furnishedarray

Furnished status. Values: 'yes', 'no', 'optional'. Default: all

gesarray

GES carbon emissions rating: 'a' (best) to 'g' (worst), 'v'=blank, 'n'=not subject. Default: all

keywordsstring

Search terms (e.g., 'terrasse', 'parking')

limitnumber

Max results to return (1-100). Default: 10

max_bedroomsnumber

Maximum number of bedrooms

max_pricenumber

Maximum monthly rent in euros

max_roomsnumber

Maximum number of rooms

max_squarenumber

Maximum surface area in m²

min_bedroomsnumber

Minimum number of bedrooms

min_pricenumber

Minimum monthly rent in euros

min_roomsnumber

Minimum number of rooms

min_squarenumber

Minimum surface area in m²

orientationarray

Property orientation. Values: 'north', 'south', 'east', 'west', 'north_east', 'north_west', 'south_east', 'south_west'. Default: all

outside_accessarray

Outside features. Values: 'balcony', 'terrace', 'garden', 'pool'. Default: all

owner_typestring

Landlord type. Values: 'all', 'pro', 'private'. Default: 'all'

property_typearray

Property types to search. Values: 'apartment', 'house', 'land', 'parking', 'other'. Default: all types

regionstring

Region ID

sort_bystring

Sort field. Values: 'price', 'date'. Default: 'date'

sort_orderstring

Sort direction. Values: 'asc', 'desc'. Default: 'desc'

specificitiesarray

Property features. Values: 'with_garage_or_parking_spot', 'equipped_kitchen', 'american_kitchen', 'bathtub', 'second_bathroom', 'impaired_mobility_friendly', 'basement', 'cellar', 'attic'. Default: all

swimming_poolarray

Swimming pool filter. Values: '1' (with pool only). Default: all

urgentarray

Urgent listings only. Values: '1' (yes). Default: all

zipcodestring

Postal code (e.g., '75001')

Search Real Estate Sales

search_real_estate_sales

Full Description

Search for real estate properties for sale on leboncoin.

All parameters are optional with sensible defaults. Returns properties matching your criteria with details like price, location, surface area, and amenities.

Parameters

Optional

citystring

City name

departmentstring

Department number (e.g., '75' for Paris)

elevatorarray

Elevator filter. Values: '1' (yes). Default: all

energy_ratearray

DPE energy rating: 'a' (best) to 'g' (worst), 'v'=blank, 'n'=not subject. Default: all

floor_propertyarray

Floor type. Values: 'ground_floor', 'upper_floor', 'last_stage'. Default: all

gesarray

GES carbon emissions rating: 'a' (best) to 'g' (worst), 'v'=blank, 'n'=not subject. Default: all

global_conditionarray

Property condition: '1'=Excellent, '2'=Good, '3'=Renovated, '4'=Needs refresh, '5'=Major work. Default: all

immo_sell_typearray

Sale type. Values: 'old', 'new', 'viager'. Default: all

keywordsstring

Search terms (e.g., 'terrasse vue mer', 'proche metro')

limitnumber

Max results to return (1-100). Default: 10

max_bedroomsnumber

Maximum number of bedrooms

max_land_surfacenumber

Maximum land plot surface in m²

max_pricenumber

Maximum price in euros

max_roomsnumber

Maximum number of rooms

max_squarenumber

Maximum surface area in m²

min_bedroomsnumber

Minimum number of bedrooms

min_land_surfacenumber

Minimum land plot surface in m²

min_pricenumber

Minimum price in euros

min_roomsnumber

Minimum number of rooms

min_squarenumber

Minimum surface area in m²

orientationarray

Property orientation. Values: 'north', 'south', 'east', 'west', 'north_east', 'north_west', 'south_east', 'south_west'. Default: all

outside_accessarray

Outside features. Values: 'balcony', 'terrace', 'garden', 'pool'. Default: all

owner_typestring

Seller type. Values: 'all', 'pro', 'private'. Default: 'all'

property_agearray

Property age. Values: 'new', 'old'. Default: all

property_typearray

Property types to search. Values: 'apartment', 'house', 'land', 'parking', 'other'. Default: all types

regionstring

Region ID

sort_bystring

Sort field. Values: 'price', 'date'. Default: 'date'

sort_orderstring

Sort direction. Values: 'asc', 'desc'. Default: 'desc'

specificitiesarray

swimming_poolarray

Swimming pool filter. Values: '1' (with pool only). Default: all

urgentarray

Urgent listings only. Values: '1' (yes). Default: all

zipcodestring

Postal code (e.g., '75001')

Search Smartphones

search_smartphones

Full Description

Search for smartphones and mobile phones on leboncoin. Returns ads with details like brand, model, memory, color, condition, warranty, price, and location.

Parameters

Required

keywordsstring

Search terms (e.g., 'iPhone 16 Pro', 'Samsung Galaxy S24', 'smartphone 128 Go')

Optional

citystring

City name for location filtering

departmentstring

Department number (e.g., '75' for Paris)

item_conditionstring

Item condition: new (brand new), refurbished (professionally restored), very_good (excellent used condition), good (normal wear), satisfactory (visible wear), for_parts (not working)

Options:newrefurbishedvery_goodgoodsatisfactoryfor_parts

limitnumber

Max results (1-100). Default: 20

max_pricenumber

Maximum price in euros

min_pricenumber

Minimum price in euros

owner_typestring

Seller type: 'all', 'pro', 'private'. Default: 'all'

phone_brandstring

Phone brand (lowercase slug)

Options:applesamsunghuaweixiaomigooglesonyoneplusoppomotorolanokiahonorlgasusfairphonealcatelautre

phone_colorstring

Phone color (lowercase French: 'noir', 'blanc', 'bleu', 'argent', 'or', 'gris', 'rose', 'rouge', 'vert', 'violet', 'orange', 'jaune', 'orrose', 'marron')

Options:noirblancbleuargentorgrisroserougevertvioletorangejauneorrosemarronautre

phone_memorystring

Memory capacity (lowercase with 'go': '64go', '128go', '256go', '512go')

Options:8go16go32go64go128go256go512go999999

phone_modelstring

Phone model (slugified format - Apple models: 'iphone16pro', 'iphone16', 'iphone15pro', 'iphone15', 'iphone14', 'iphone13', 'iphone12', 'iphone11'. Samsung models: 'samsung_galaxys24', 'samsung_galaxya52', 'samsung_galaxyfold'. Other brands follow pattern: 'brand_model')

regionstring

Region ID

shippableboolean

Filter for items that can be shipped

sort_bystring

Sort field: 'relevance', 'price', 'date'. Default: 'relevance'

sort_orderstring

Sort direction: 'asc', 'desc'. Default: 'desc'

warranty_eligibleboolean

Filter for items eligible to warranty

Links

Website Privacy Policy Terms of Service