Path Parameters
The Leboncoin ad id (an integer). You can find this in search results or extract it from an ad URL (
/{slug}/{list_id}.htm).Response
Full ad object.
Show Ad object
Show Ad object
Leboncoin ad id (integer).
Ad title.
Ad description text.
Brand name, if detected (nullable).
offer or demand.Full URL to the ad.
Ad status (e.g.
active).Leboncoin category id.
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).
Category-specific attributes.
Show AdAttribute object
Show AdAttribute object
Attribute machine key (e.g.
brand).Human-readable attribute label (e.g.
Marque).Attribute machine value.
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.
Show Location object
Show Location object
Country id. Always
FR.French region id (nullable).
Region name (nullable).
Department id (nullable).
Department name (nullable).
City machine name (nullable).
City display name (nullable).
Postal code (nullable).
District / neighbourhood (nullable).
Latitude (nullable).
Longitude (nullable).
Whether the location is an approximate shape rather than an exact point.
Ad owner summary.
Show Owner object
Show Owner object
Example Response
{
"ad": {
"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, autonomie 90 km.",
"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 },
{ "key": "condition", "key_label": "État", "value": "used", "value_label": "Très bon état", "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
}
}
}
Each ad-detail request costs 5 credits. Failed requests are not charged.