Query Parameters
Search keywords. Matches against ad titles and descriptions.
Restrict results to a French region (includes DOM-TOM overseas territories). Use /v1/leboncoin/regions to look up ids. Restrict results to a French postal code.
Minimum price filter in euros.
Maximum price filter in euros.
Filter by seller type.| Value | Description |
|---|
all | All sellers (default) |
pro | Professional sellers only |
private | Private individuals only |
Filter by ad type.| Value | Description |
|---|
offer | Items offered for sale (default) |
demand | Wanted / demand ads |
sort
string
default:"relevance"
Sort order for results.| Value | Description |
|---|
relevance | Best match (default) |
newest | Most recently published first |
oldest | Oldest first |
price_low | Cheapest first |
price_high | Most expensive first |
Page number for paginated results.
Results per page. Maximum 100.
Response
Array of matching ads.
Leboncoin ad id (integer).
Brand name, if detected (nullable).
Human-readable category name.
Price in euros as an array (Leboncoin returns price as a list of integers).
Price in cents (nullable).
Price in euros as a number (nullable).
Currency code. Always EUR.
Raw first-publication date as shown on Leboncoin.
ISO 8601 first-publication timestamp.
Raw index (last-bumped) date.
ISO 8601 index timestamp.
Raw expiration date (nullable).
ISO 8601 expiration timestamp (nullable).
Whether the seller published a phone number.
Number of times the ad was favorited (nullable).
Image set for the ad.
Standard-resolution image URLs.
Large / full-resolution image URLs.
Category-specific attributes.
Attribute machine key (e.g. brand).
Human-readable attribute label (e.g. Marque).
Human-readable attribute value.
List of values for multi-value attributes (nullable).
Whether the attribute is generic (shared across categories).
Geographic location of the ad.
French region id (nullable).
Department id (nullable).
Department name (nullable).
City machine name (nullable).
City display name (nullable).
District / neighbourhood (nullable).
Whether the location is an approximate shape rather than an exact point.
Ad owner summary.
Store id, for pro sellers with a storefront (nullable).
SIREN company registration number, for pro sellers (nullable).
Whether the seller opted out of solicitation.
Number of ads matching the current filters.
Total ads matching the query across all seller types.
Total matching ads from professional sellers.
Total matching ads from private sellers.
Total matching ads eligible for shipping.
Maximum number of pages available for this query.
The page that was returned.
The page size that was applied.
The upstream source the results were scraped from.
Example Response
{
"ads": [
{
"list_id": 2845123456,
"subject": "Vélo électrique VTC 500W - Excellent état",
"body": "Vélo électrique acheté il y a 6 mois, très peu servi. Batterie 48V.",
"brand": "Moustache",
"ad_type": "offer",
"url": "https://www.leboncoin.fr/velos/2845123456.htm",
"status": "active",
"category_id": "24",
"category_name": "Vélos",
"price": [890],
"price_cents": 89000,
"price_eur": 890.0,
"currency": "EUR",
"first_publication_date": "2026-06-18 09:42:11",
"first_publication_at": "2026-06-18T09:42:11Z",
"index_date": "2026-06-20 14:10:03",
"index_at": "2026-06-20T14:10:03Z",
"expiration_date": "2026-08-17 09:42:11",
"expiration_at": "2026-08-17T09:42:11Z",
"has_phone": true,
"favorites": 12,
"images": {
"nb_images": 3,
"urls": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd.jpg"],
"urls_thumb": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd_thumb.jpg"],
"urls_large": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ab/cd/abcd_large.jpg"]
},
"attributes": [
{ "key": "brand", "key_label": "Marque", "value": "moustache", "value_label": "Moustache", "generic": true }
],
"location": {
"country_id": "FR",
"region_id": "22",
"region_name": "Île-de-France",
"department_id": "75",
"department_name": "Paris",
"city": "paris",
"city_label": "Paris 11e",
"zipcode": "75011",
"lat": 48.8594,
"lng": 2.3765,
"is_shape": false
},
"owner": {
"user_id": "b3f1c2a0-8d4e-4a1b-9c2d-1e2f3a4b5c6d",
"type": "private",
"name": "Julien",
"no_salesmen": true
}
}
],
"total": 1284,
"total_all": 1284,
"total_pro": 312,
"total_private": 972,
"total_shippable": 540,
"max_pages": 37,
"page": 1,
"limit": 35,
"source": "leboncoin.fr"
}
Each search request costs 5 credits. Failed requests are not charged.
