Get Similar Ads

Path Parameters

list_id

integer

required

The Leboncoin ad id (an integer) to find similar ads for.

Query Parameters

limit

integer

default:20

Maximum number of similar ads to return. Maximum 100.

Response

list_id

integer

The ad id the similar ads were requested for.

ads

array

Array of similar ads (same Ad shape as search).

Show Ad object

list_id

integer

Leboncoin ad id (integer).

subject

string

Ad title.

body

string

Ad description text.

ad_type

string

offer or demand.

url

string

Full URL to the ad.

category_id

string

Leboncoin category id.

category_name

string

Human-readable category name.

price

array

Price in euros as an array of integers.

price_eur

number

Price in euros as a number (nullable).

currency

string

Currency code. Always EUR.

first_publication_at

string

ISO 8601 first-publication timestamp.

images

object

Image set with nb_images, urls, urls_thumb, urls_large.

location

object

Location with region_id, region_name, department_id, city_label, zipcode, lat, lng.

owner

object

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.

Overview

Search

Ads

Sellers

Reference

Path Parameters

Query Parameters

Response

Example Response

​Path Parameters

​Query Parameters

​Response

​Example Response

Path Parameters

Query Parameters

Response

Example Response