Can I use an ad URL instead of an ID?

Yes. The listing field accepts either.

How many ads can I get?

Up to 100 per request with max_items. Use start_page to continue.

Do I pay for lookups that come back empty?

No. You are charged per result, so a request that finds nothing costs nothing. Testing this against a messy list is free to get wrong.

What does a pull cost?

1 point per returned ad, which is $1 per 1,000.

E-commerce & Marketplaces

Leboncoin Similar Listings — Annonces Similaires for Any Ad

Send a Leboncoin ad ID or URL and this source returns the annonces similaires Leboncoin recommends for it, one record per ad, in the same shape as a full ad: title, description, price, category attributes, images, location and seller.

Run it in the app Read the API docs

Example response

{
  "session_id": "11111111-1111-1111-1111-111111111111",
  "kind": "leboncoin_listings_similar",
  "listing": "3188662248",
  "max_items": 2,
  "start_page": 1,
  "human": "# leboncoin similar listings\n\n- **Listing:** 3188662248\n- **Max items:** 2\n- **Starting page:** 1\n- **Records returned:** 2\n- **Proxy traffic:** 13.5 KB",
  "machine": {
    "total_items": 2,
    "items": [
      {
        "@type": "LeboncoinListing",
        "id": "2998491796",
        "url": "https://www.leboncoin.fr/ad/ordinateurs/2998491796",
        "name": "MACBOOK AIR M2 2023/16Go/512Go/13P",
        "description": "💻 MacBook air 13” M2  – 16Go RAM / 512Go SSD\n\nChez Mac Store et Cie, nous sommes spécialisés depuis plus de 6 ans dans les produits Apple d’occasion haut de gamme. Tous nos appareils sont en excellent",
        "price": 890,
        "currency": "EUR",
        "category_id": "15",
        "category": "Ordinateurs",
        "ad_type": "offer",
        "status": "active",
        "created_at": 1789678151,
        "updated_at": 1789678151,
        "expires_at": 1794862151,
        "image": "https://img.leboncoin.fr/api/v1/lbcpb1/images/d7/7e/55/d77e55e5799bd3a5b53fa66045d0ac15796d33be.jpg?rule=ad-image",
        "images": [
          "https://img.leboncoin.fr/api/v1/lbcpb1/images/d7/7e/55/d77e55e5799bd3a5b53fa66045d0ac15796d33be.jpg?rule=ad-image",
          "https://img.leboncoin.fr/api/v1/lbcpb1/images/57/b7/81/57b7811f55b03d3d6f94c1ad39cd76798e1a88a1.jpg?rule=ad-image"
        ],
        "image_count": 5,
        "attributes": {
          "État": "Très bon état",
          "Type": "Portable",
          "Marque": "Apple",
          "Taille d'écran": "12 à 14” (33cm à 37cm)",
          "Usage": "Polyvalent",
          "Durée de disponibilité des pièces détachées": "10 ans"
        },
        "region": "Ile-de-France",
        "department": "Paris",
        "city": "Paris",
        "zipcode": "75011",
        "lat": 48.85763,
        "lng": 2.38005,
        "is_urgent": false,
        "is_boosted": false,
        "has_phone": true,
        "favorite_count": null,
        "seller": {
          "@type": "LeboncoinListingSeller",
          "id": "44206412",
          "user_id": "d2bbd79d-7712-4b18-8582-1a9c62fc9673",
          "name": "Mac store & cie",
          "is_pro": true,
          "siren": "890529845",
          "activity_sector_id": "3"
        }
      },
      {
        "@type": "LeboncoinListing",
        "id": "3158878140",
        "url": "https://www.leboncoin.fr/ad/ordinateurs/3158878140",
        "name": "MACBOOK AIR M1 2020 /8Go/256Go SSD /13P",
        "description": "💻 MacBook air 13” M1– 8Go RAM / 256Go SSD 13 pouce\nChez Mac Store et Cie, nous sommes spécialisés depuis plus de 6 ans dans les produits Apple d’occasion haut de gamme.\n\n✨ Caractéristiques\n• Processeu",
        "price": 499,
        "currency": "EUR",
        "category_id": "15",
        "category": "Ordinateurs",
        "ad_type": "offer",
        "status": "active",
        "created_at": 1789677958,
        "updated_at": 1789677958,
        "expires_at": 1794861958,
        "image": "https://img.leboncoin.fr/api/v1/lbcpb1/images/9f/58/01/9f58019bb0489d0f2919a53f3833d99bee9d56fb.jpg?rule=ad-image",
        "images": [
          "https://img.leboncoin.fr/api/v1/lbcpb1/images/9f/58/01/9f58019bb0489d0f2919a53f3833d99bee9d56fb.jpg?rule=ad-image",
          "https://img.leboncoin.fr/api/v1/lbcpb1/images/5c/b4/38/5cb438d0315edca0b63a01de79fdc45e6fdabb04.jpg?rule=ad-image"
        ],
        "image_count": 5,
        "attributes": {
          "État": "État neuf",
          "Type": "Portable",
          "Marque": "Apple",
          "Taille d'écran": "12 à 14” (33cm à 37cm)",
          "Usage": "Polyvalent",
          "Durée de disponibilité des pièces détachées": "10 ans"
        },
        "region": "Ile-de-France",
        "department": "Paris",
        "city": "Paris",
        "zipcode": "75011",
        "lat": 48.86005,
        "lng": 2.37601,
        "is_urgent": false,
        "is_boosted": false,
        "has_phone": true,
        "favorite_count": null,
        "seller": {
          "@type": "LeboncoinListingSeller",
          "id": "44206412",
          "user_id": "d2bbd79d-7712-4b18-8582-1a9c62fc9673",
          "name": "Mac store & cie",
          "is_pro": true,
          "siren": "890529845",
          "activity_sector_id": "3"
        }
      }
    ],
    "response_bytes": 13838
  },
  "total_points": 2
}

You send: A Leboncoin ad ID or listing URL
You get back: Similar ads with title, price, attributes, images, location and seller
Coverage: Similar ads shown for public Leboncoin ads.
Price: 1 point per returned result, up to 100 per request — $1 per 1,000; Billed per ad actually returned, capped by max_items. An ad with no similar ads costs nothing.

Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

Approach	What it takes	Cost	Trade-off
Checking it by hand	Open the ad and scroll to the similar-ads section	Free, and slow	Fine for one ad, useless across many
Building a scraper	Write it, host it, and repair it when the ad page changes	Engineering time	A maintenance commitment for something that isn't your product
NeuralVerge	One request per ad	$1 per 1,000, misses not billed	What counts as similar is the site's choice, not yours

Response

What you get back

Every field in the response shown above.

Field	Type	Description
`total_items`	number	How many ads were returned in this batch (capped by max_items).
`items`	array	The similar ads.
`@type`	string	Record type, LeboncoinListing.
`id`	string	Leboncoin ad ID.
`url`	string	Direct link to the ad.
`name`	string	Ad title.
`description`	string	Ad description, which can be truncated.
`price`	number	Asking price.
`currency`	string	ISO currency code.
`category_id`	string	Category ID.
`category`	string	Category name, in French.
`ad_type`	string	Ad type, e.g. offer.
`status`	string	Ad status, e.g. active.
`created_at`	number	Publication time as a Unix timestamp.
`updated_at`	number	Last update time as a Unix timestamp.
`expires_at`	number	Expiry time as a Unix timestamp.
`image`	string	Primary image URL.
`images`	array	Image URLs returned for the ad.
`image_count`	number	Number of images on the ad.
`attributes`	object	Category-specific attributes as label and value pairs, in French.
`region`	string	Region.
`department`	string	Department.
`city`	string	City.
`zipcode`	string	Postcode.
`lat`	number	Latitude.
`lng`	number	Longitude.
`is_urgent`	boolean	Whether the ad carries the urgent flag.
`is_boosted`	boolean	Whether the ad is boosted.
`has_phone`	boolean	Whether the ad has a phone number attached.
`favorite_count`	number	Favourite count, when shown. Null otherwise.
`seller`	object	Seller id, user_id, name, is_pro, siren and activity_sector_id.

Integration

How to run it

The same lookup works from the app, the API, or as a tool an agent can call mid-task.

max_items defaults to 10 and goes up to 100. Use start_page to continue past a previous request.

curl -X POST https://api.neuralverge.ai/functions/v1/run-leboncoin-listings-similar \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "listing": "3188662248", "max_items": 2 }'

Use cases

What teams use it for

Where this field shows up in an actual workflow.

Price sanity checks

Compare an ad's price with the similar ads Leboncoin shows for it.

Comparable sets

Start from one reference ad and collect similar ones without writing a query.

Seller discovery

See which sellers, professional or private, list similar goods in the same area.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Similar ads shown for public Leboncoin ads.

Freshness

Read at request time.

Handling

This source returns publicly visible ad information, stamped with the ad ID it was run for and a session id you can trace. Ads can identify private individuals and locations, so handle them with your own data-protection obligations in mind.

What it will not do

—The selection of similar ads is made by the site and can differ from one request to the next.
—Descriptions can be cut short.
—Attributes depend on the category; labels and values are in French.
—Timestamps are Unix values and need converting.

FAQ

Questions, answered

By Leboncoin. We return the set the site recommends for the ad; we don't re-rank it.

Related sources

Leboncoin listing

A full Leboncoin ad by ID or URL: price, category attributes, images, location, dates and seller.

Leboncoin seller

A Leboncoin professional store: name, SIREN/SIRET, sector, hours, website, address, rating, services and team.

Leboncoin categories

The Leboncoin category tree with IDs, slugs, parents and subcategories, plus an optional search-filter catalogue.

All e-commerce & marketplaces

Amazon, eBay, Walmart, AliExpress and Alibaba product, seller and review data.

Try leboncoin similar listings on your own data

One request format across every source in the catalog.

Get started