Search Ads

Query Parameters

string

Search keywords. Matches against ad titles and descriptions.

string

Restrict results to a Leboncoin category id. Use /v1/leboncoin/categories to look up ids.

string

Restrict results to a French region (includes DOM-TOM overseas territories). Use /v1/leboncoin/regions to look up ids.

string

Restrict results to a French department. Use /v1/leboncoin/departments to look up ids.

string

Restrict results to a city name. Resolve names with /v1/leboncoin/locations/search.

string

Restrict results to a French postal code.

integer

Minimum price filter in euros.

integer

Maximum price filter in euros.

string

default:"all"

Filter by seller type.

Value	Description
`all`	All sellers (default)
`pro`	Professional sellers only
`private`	Private individuals only

string

default:"offer"

Filter by ad type.

Value	Description
`offer`	Items offered for sale (default)
`demand`	Wanted / demand ads

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

integer

default:1

Page number for paginated results.

integer

default:35

Results per page. Maximum 100.

Response

array

Array of matching ads.

Show Ad object

integer

Leboncoin ad id (integer).

string

Ad title.

string

Ad description text.

string

Brand name, if detected (nullable).

string

offer or demand.

string

Full URL to the ad.

string

Ad status (e.g. active).

string

Leboncoin category id.

string

Human-readable category name.

array

Price in euros as an array (Leboncoin returns price as a list of integers).

integer

Price in cents (nullable).

number

Price in euros as a number (nullable).

string

Currency code. Always EUR.

string

Raw first-publication date as shown on Leboncoin.

string

ISO 8601 first-publication timestamp.

string

Raw index (last-bumped) date.

string

ISO 8601 index timestamp.

string

Raw expiration date (nullable).

string

ISO 8601 expiration timestamp (nullable).

boolean

Whether the seller published a phone number.

integer

Number of times the ad was favorited (nullable).

object

Image set for the ad.

Show Images object

integer

Total number of images.

array

Standard-resolution image URLs.

array

Thumbnail image URLs.

array

Large / full-resolution image URLs.

array

Category-specific attributes.

Show AdAttribute object

string

Attribute machine key (e.g. brand).

string

Human-readable attribute label (e.g. Marque).

string

Attribute machine value.

string

Human-readable attribute value.

array

List of values for multi-value attributes (nullable).

boolean

Whether the attribute is generic (shared across categories).

object

Geographic location of the ad.

Show Location object

string

Country id. Always FR.

string

French region id (nullable).

string

Region name (nullable).

string

Department id (nullable).

string

Department name (nullable).

string

City machine name (nullable).

string

City display name (nullable).

string

Postal code (nullable).

string

District / neighbourhood (nullable).

number

Latitude (nullable).

number

Longitude (nullable).

boolean

Whether the location is an approximate shape rather than an exact point.

object

Ad owner summary.

Show Owner object

string

Seller UUID.

string

Store id, for pro sellers with a storefront (nullable).

string

private or pro.

string

Seller display name.

string

SIREN company registration number, for pro sellers (nullable).

boolean

Whether the seller opted out of solicitation.

integer

Number of ads matching the current filters.

integer

Total ads matching the query across all seller types.

integer

Total matching ads from professional sellers.

integer

Total matching ads from private sellers.

integer

Total matching ads eligible for shipping.

integer

Maximum number of pages available for this query.

integer

The page that was returned.

integer

The page size that was applied.

string

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.

Overview

Search

Ads

Sellers

Reference

Query Parameters

Response

Example Response

​Query Parameters

​Response

​Example Response

Query Parameters

Response

Example Response