Skip to main content
GET
/
v1
/
results
Get Results
curl --request GET \
  --url https://api.lobstr.io/v1/results \
  --header 'Authorization: <authorization>'
{
  "annonce_id": "<string>",
  "title": "<string>",
  "price": 123,
  "url": "<string>",
  "description": "<string>",
  "mail": "<string>",
  "pictures": "<string>",
  "urgent": true,
  "picture": "<string>",
  "category_name": "<string>",
  "currency": "<string>",
  "region": "<string>",
  "department": "<string>",
  "city": "<string>",
  "city_label": "<string>",
  "postal_code": "<string>",
  "is_exclusive": true,
  "first_publication_date": {},
  "last_publication_date": {},
  "expiration_date": {},
  "status": "<string>",
  "owner_type": "<string>",
  "owner_name": "<string>",
  "user_id": "<string>",
  "custom_ref": "<string>",
  "api_key": "<string>",
  "GES_string": "<string>",
  "GES": "<string>",
  "DPE_string": "<string>",
  "DPE": "<string>",
  "room_count": 123,
  "sleepingroom_count": 123,
  "charges_included": true,
  "area": 123,
  "floor": 123,
  "price_per_square_meter": 123,
  "furnished": true,
  "real_estate_type": "<string>",
  "details": "<string>",
  "more_details": "<string>",
  "functions": "<string>",
  "lat": "<string>",
  "lng": "<string>",
  "ad_type": "<string>",
  "no_salesmen": true,
  "hash_value": "<string>",
  "has_online_shop": true,
  "online_shop_url": "<string>",
  "capacity": 123,
  "has_swimming_pool": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve scraped data from your Leboncoin Listings Search Export runs.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
squid
string
required
Hash of the squid to get results from
​
run
string
Hash of a specific run (optional)
​
page
integer
Page number (default: 1). Example: 1

​
Result Fields

Each result object contains the following fields:
​
annonce_id
string
Unique identifier for the listing on Leboncoin. Example: 3066299454
​
title
string
Title of the listing as posted on Leboncoin. Example: Villa 5 pièces 105 m²
​
price
integer
Listed price of the item or property. Example: 1669
​
url
string
Direct URL to the listing on Leboncoin. Example: https://www.leboncoin.fr/ad/locations/3066299454
​
description
text
Full description text of the listing. Example: `Villa 5 pièces 105 m²Dans bel environnement, A LOUER VELAUX, Villa meublée type 5 d’une surface habitable de 104,89 m² sur terrain de 1100 m². RDC : pièce principale comprenant cuisine équipée américaine donnant sur salon/salle à manger avec cheminée, deux chambres/placards ,une salle de bains avec douche et baignoire, un WC. 1er étage : une chambre en mezzanine. Terrasse - Garage/buanderie - Climatisation réversible.Disponible le 26/10/2025Surface : 105 m² Loyer : 1669 € / mois (charges comprises) Montant des charges : 275 € / mois Modalité de récupération des charges locatives : Prévisionnelles mensuelles avec régularisation annuelle Honoraires à la charge du locataire : 1363.57 € dont 314.67 € pour l’état des lieux Dépôt de garantie : 1394 € Date de réalisation du diagnostic énergétique : 23/08/2023Consommation énergie primaire : 105 kWh/m²/an Consommation énergie finale : Non communiquéMontant estimé des dépenses annuelles d’énergie pour un usage standard : entre 700 € et 1 000 € par an. Prix moyens des énergies indexés sur l’année Non communiqué (abonnements compris)Les informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : www.georisques.gouv.fr`
​
mail
string
Email address of the seller (if available)
​
pictures
string
Comma or pipe-separated list of picture URLs for the listing. Example: https://img.leboncoin.fr/api/v1/lbcpb1/images/84/bc/c2/84bcc22c34147d593b771914b7db7b9791c71c3c.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/5e/3a/b8/5e3ab867f9aa30a25468436e42dba41a2b370e7c.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/19/c8/9e/19c89ecf270b6226dcd53fa8143c7648f45c0490.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/af/1d/49/af1d49b6959bb680cc8f69ae247d0717a2cf4b6d.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/82/31/e7/8231e732a0de87ead42bbb9cd742684c70774b17.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/07/22/61/0722611838ca516a49bdc6a268d214ffb55a009c.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/47/93/9a/47939ab21ff66dd56d36ddc15a7d5893bcc85605.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/86/df/0f/86df0ffa2e1372b81592425010ffe72b3c2367ec.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/4d/21/49/4d2149a3b309d3111fd3173e21aae6f7970eb6ed.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/8a/e5/5b/8ae55b11c86f9239fe1aaa609d3f464fb0066911.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/a8/4b/43/a84b437d2131284c78070a4d134087cf6c549923.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/0d/1c/24/0d1c24d24de4bf966c175a5948f575e11c405b10.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/gh/80/1a/gh801aacb6ad35f5d8860634825fb792be5c1d97.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/d7/42/86/d742868f726238dd3daf190d8a936c1ece7056b9.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/3d/4b/b8/3d4bb89200c27f5c1219a0e79e7fb1103f68679a.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/f9/d4/f3/f9d4f36d5fd362518f6954b0e61738c3550113e8.jpg?rule=ad-large, https://img.leboncoin.fr/api/v1/lbcpb1/images/91/f7/e7/91f7e7308223c788eea4531ba949541d61141e07.jpg?rule=ad-large
​
urgent
boolean
Whether the listing is marked as urgent on Leboncoin. Example: false
​
picture
string
URL of the listing’s main picture. Example: https://img.leboncoin.fr/api/v1/lbcpb1/images/84/bc/c2/84bcc22c34147d593b771914b7db7b9791c71c3c.jpg?rule=ad-large
​
category_name
string
Category of the listing on Leboncoin (e.g. Immobilier, Voitures). Example: Locations
​
currency
string
Currency of the listed price. Example: EUR
​
region
string
French region where the listing is located. Example: Provence-Alpes-Côte d'Azur
​
department
string
French department where the listing is located. Example: Bouches-du-Rhône
​
city
string
City where the listing is located. Example: Velaux
​
city_label
string
Formatted city name label as shown on Leboncoin. Example: Velaux 13880
​
postal_code
string
French postal code of the listing location. Example: 13880
​
is_exclusive
boolean
Whether the listing has an exclusive promotion on Leboncoin
​
first_publication_date
datetime
Date the listing was first published on Leboncoin. Example: 2025-09-29T12:33:03+00:00
​
last_publication_date
datetime
Date the listing was last published or renewed on Leboncoin. Example: 2025-09-29T12:33:03+00:00
​
expiration_date
datetime
Date the listing expires or is automatically removed
​
status
string
Current status of the listing on Leboncoin (e.g. active, expired)
​
owner_type
string
Type of seller (private individual or professional). Example: 1
​
owner_name
string
Name of the seller or business. Example: A C D IMMOBILIER VILLAGE
​
user_id
string
Unique identifier of the seller on Leboncoin. Example: 5e25f2ef-d2b7-4694-a321-e7a992df327e
​
custom_ref
string
Custom reference number assigned by the seller
​
api_key
string
Internal API key used by the scraper. Example: 54bb0281238b45a03f0ee695f73e704f
​
GES_string
string
Greenhouse gas emissions (GES) label as displayed on Leboncoin (e.g. A, B, C). Example: A
​
GES
string
Greenhouse gas emissions (GES) rating object. Example: a
​
DPE_string
string
Energy Performance Diagnostic (DPE) label as displayed on Leboncoin (e.g. A, B, C). Example: B
​
DPE
string
Energy Performance Diagnostic (DPE) rating object. Example: b
​
room_count
integer
Total number of rooms in the property. Example: 5
​
sleepingroom_count
integer
Number of bedrooms in the property
​
charges_included
boolean
Whether service charges (charges) are included in the listed price. Example: true
​
area
integer
Living surface area of the property in square metres. Example: 105
​
floor
integer
Floor level of the property
​
price_per_square_meter
float
Calculated price per square metre
​
furnished
boolean
Whether the property is furnished. Example: true
​
real_estate_type
string
Type of real estate (e.g. apartment, house, land). Example: Maison
​
details
string
Additional listing attributes returned by the Leboncoin API (JSON). Example: {"GES": "A", "Extérieur": "Terrasse, Jardin", "Honoraires": "1364", "Référence": "1059", "Type de bien": "Maison", "Ce bien est :": "Meublé", "État du bien": "Bon état", "Frais d'agence": "19.73 %", "Classe énergie": "B", "Charges incluses": "Oui", "Caractéristiques": "Cuisine équipée", "Charges locatives": "275 €", "Mode de chauffage": "Autre", "Nombre de pièces": "5", "Surface habitable": "105 m²", "Type de chauffage": "Individuel", "Nombre de chambres": "3 ch.", "Dépôt de garantie": "1394 €", "Prix hors honoraires": "1394 €", "Étage de votre bien": "0", "Montant des honoraires": "275 €", "Frais d'état des lieux": "315 €", "Nombre de salles de bain": "1", "Surface totale du terrain": "1100 m²", "Loyer mensuel (hors charges)": "1394", "Bien soumis à l'encadrement des loyers": "Non"}
​
more_details
string
Extended listing details returned by the Leboncoin API (JSON). Example: {"ges": "A", "rooms": "5", "square": "105 m²", "bedrooms": "3 ch.", "furnished": "Meublé", "is_import": "true", "custom_ref": "1059", "fees_price": "275 €", "lease_type": "rent", "district_id": "13112", "energy_rate": "B", "rental_fees": "1364", "floor_number": "0", "heating_mode": "Autre", "heating_type": "Individuel", "mandate_type": "simple", "nb_bathrooms": "1", "specificities": "Cuisine équipée", "external_ad_id": "ac3_8875_19616623", "inventory_fees": "315 €", "outside_access": "Terrasse, Jardin", "pro_rates_link": "https://media.immo-facile.com/segments/immo/catalog/images/manufacturers_bareme/39735.pdf", "activity_sector": "2", "monthly_charges": "275 €", "charges_included": "Oui", "district_type_id": "2", "global_condition": "Bon état", "real_estate_type": "Maison", "security_deposit": "1394 €", "land_plot_surface": "1100 m²", "price_except_fees": "1394 €", "district_visibility": "false", "is_public_rent_control": "Non", "rent_excluding_charges": "1394", "district_resolution_type": "integration", "negotiating_fees_percentage": "19.73 %"}
​
functions
string
Additional enrichment functions enabled for this record. Example: {"phone": {"filling_date": "09/30/2025, 14:21:24 +0200"}}
​
lat
string
Latitude coordinate of the listing location. Example: 43.5237
​
lng
string
Longitude coordinate of the listing location. Example: 5.2578
​
ad_type
string
Type of advertisement on Leboncoin (offer or request). Example: offer
​
no_salesmen
boolean
Whether the listing is from a private seller only (no professionals). Example: false
​
hash_value
string
Internal hash used to identify this listing version. Example: e3d8cc836e81c6a2488f8871f8d4502f
​
has_online_shop
boolean
Whether the seller has an online shop on Leboncoin. Example: true
​
online_shop_url
string
URL to the seller’s Leboncoin shop. Example: https://www.leboncoin.fr/boutique/21494
​
capacity
integer
Capacity of the space (e.g. number of guests for accommodation listings)
​
has_swimming_pool
boolean
Whether the property has a swimming pool