Search Ads

Query Parameters

text

string

Search keywords. Matches against ad titles and descriptions.

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

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

Value	Description
`relevance`	Best match (default)
`newest`	Most recently published first
`oldest`	Oldest first
`price_low`	Cheapest first
`price_high`	Most expensive first

Response

ads

array

Array of matching ads.

Show Ad object

list_id

integer

Leboncoin ad id (integer).

subject

string

Ad title.

body

string

Ad description text.

brand

string

Brand name, if detected (nullable).

ad_type

string

offer or demand.

url

string

Full URL to the ad.

status

string

Ad status (e.g. active).

category_id

string

Leboncoin category id.

category_name

string

Human-readable category name.

price

array

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

price_cents

integer

Price in cents (nullable).

price_eur

number

Price in euros as a number (nullable).

currency

string

Currency code. Always EUR.

first_publication_date

string

Raw first-publication date as shown on Leboncoin.

first_publication_at

string

ISO 8601 first-publication timestamp.

index_date

string

Raw index (last-bumped) date.

index_at

string

ISO 8601 index timestamp.

expiration_date

string

Raw expiration date (nullable).

expiration_at

string

ISO 8601 expiration timestamp (nullable).

has_phone

boolean

Whether the seller published a phone number.

favorites

integer

Number of times the ad was favorited (nullable).

images

object

Image set for the ad.

Show Images object

nb_images

integer

Total number of images.

urls

array

Standard-resolution image URLs.

urls_thumb

array

Thumbnail image URLs.

urls_large

array

Large / full-resolution image URLs.

attributes

array

Category-specific attributes.

Show AdAttribute object

key

string

Attribute machine key (e.g. brand).

key_label

string

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

value

string

Attribute machine value.

value_label

string

Human-readable attribute value.

values

array

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

generic

boolean

Whether the attribute is generic (shared across categories).

location

object

Geographic location of the ad.

Show Location object

country_id

string

Country id. Always FR.

region_id

string

French region id (nullable).

region_name

string

Region name (nullable).

department_id

string

Department id (nullable).

department_name

string

Department name (nullable).

city

string

City machine name (nullable).

city_label

string

City display name (nullable).

zipcode

string

Postal code (nullable).

district

string

District / neighbourhood (nullable).

lat

number

Latitude (nullable).

lng

number

Longitude (nullable).

is_shape

boolean

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

owner

object

Ad owner summary.

Show Owner object

user_id

string

Seller UUID.

store_id

string

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

type

string

private or pro.

name

string

Seller display name.

siren

string

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

no_salesmen

boolean

Whether the seller opted out of solicitation.

total

integer

Number of ads matching the current filters.

total_all

integer

Total ads matching the query across all seller types.

total_pro

integer

Total matching ads from professional sellers.

total_private

integer

Total matching ads from private sellers.

total_shippable

integer

Total matching ads eligible for shipping.

max_pages

integer

Maximum number of pages available for this query.

page

integer

The page that was returned.

limit

integer

The page size that was applied.

source

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