Path Parameters
The Leboncoin ad id (an integer) to find similar ads for.
Query Parameters
Maximum number of similar ads to return. Maximum 100.
Response
The ad id the similar ads were requested for.
Array of similar ads (same Ad shape as search).
Leboncoin ad id (integer).
Human-readable category name.
Price in euros as an array of integers.
Price in euros as a number (nullable).
Currency code. Always EUR.
ISO 8601 first-publication timestamp.
Image set with nb_images, urls, urls_thumb, urls_large.
Location with region_id, region_name, department_id, city_label, zipcode, lat, lng.
Owner summary with user_id, type, name.
Example Response
{
"list_id": 2845123456,
"ads": [
{
"list_id": 2846987654,
"subject": "Vélo électrique ville - Bon état",
"body": "Vélo électrique urbain, batterie récente, freins à disque.",
"ad_type": "offer",
"url": "https://www.leboncoin.fr/velos/2846987654.htm",
"category_id": "24",
"category_name": "Vélos",
"price": [750],
"price_eur": 750.0,
"currency": "EUR",
"first_publication_at": "2026-06-19T11:05:00Z",
"images": {
"nb_images": 2,
"urls": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ef/gh/efgh.jpg"],
"urls_thumb": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ef/gh/efgh_thumb.jpg"],
"urls_large": ["https://img.leboncoin.fr/api/v1/lbcpb1/images/ef/gh/efgh_large.jpg"]
},
"location": {
"region_id": "22",
"region_name": "Île-de-France",
"department_id": "92",
"city_label": "Boulogne-Billancourt",
"zipcode": "92100",
"lat": 48.8355,
"lng": 2.2404
},
"owner": {
"user_id": "c4a2d3b1-9e5f-4b2c-8d3e-2f3a4b5c6d7e",
"type": "private",
"name": "Amélie"
}
}
]
}
Each similar-ads request costs 5 credits. Failed requests are not charged.
