Skip to content
Examples

Get Results

Retrieve scraped data from Leboncoin Listings & Phone Search Export

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Leboncoin Listings & Phone Search Export runs.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from

runstringquery

Hash of a specific run (optional)

pageintegerquery

Page number (default: 1). Example: 1

Result Fields

Each result object contains the following fields:

annonce_idstring

Unique identifier for the listing on Leboncoin. Example: 3066299454

titlestring

Title of the listing as posted on Leboncoin. Example: Villa 5 pièces 105 m²

priceinteger

Listed price of the item or property. Example: 1669

urlstring

Direct URL to the listing on Leboncoin. Example: https://www.leboncoin.fr/ad/locations/3066299454

descriptionstring

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/2025

Surface : 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/2023

Consommation é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`

mailstring

Email address of the seller (if available)

picturesstring

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

urgentboolean

Whether the listing is marked as urgent on Leboncoin. Example: false

picturestring

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_namestring

Category of the listing on Leboncoin (e.g. Immobilier, Voitures). Example: Locations

currencystring

Currency of the listed price. Example: EUR

regionstring

French region where the listing is located. Example: Provence-Alpes-Côte d'Azur

departmentstring

French department where the listing is located. Example: Bouches-du-Rhône

citystring

City where the listing is located. Example: Velaux

city_labelstring

Formatted city name label as shown on Leboncoin. Example: Velaux 13880

postal_codestring

French postal code of the listing location. Example: 13880

is_exclusiveboolean

Whether the listing has an exclusive promotion on Leboncoin

is_boostedboolean

Whether the listing has a paid boost on Leboncoin. Example: false

first_publication_datedatetime

Date the listing was first published on Leboncoin. Example: 2025-09-29T12:33:03+00:00

last_publication_datedatetime

Date the listing was last published or renewed on Leboncoin. Example: 2025-09-29T12:33:03+00:00

expiration_datedatetime

Date the listing expires or is automatically removed

has_phoneboolean

Whether a phone number is visible on the listing. Example: true

statusstring

Current status of the listing on Leboncoin (e.g. active, expired)

is_mobileboolean

Whether the listing is for a mobile home or caravan

phonestring

Phone number extracted from the listing. Example: 0442747158

phone_from_userboolean

Phone number retrieved from the seller's Leboncoin profile

has_online_shopboolean

Whether the seller has an online shop on Leboncoin. Example: true

online_shop_urlstring

URL to the seller's Leboncoin shop. Example: https://www.leboncoin.fr/boutique/21494

owner_typestring

Type of seller (private individual or professional). Example: 1

owner_namestring

Name of the seller or business. Example: A C D IMMOBILIER VILLAGE

user_idstring

Unique identifier of the seller on Leboncoin. Example: 5e25f2ef-d2b7-4694-a321-e7a992df327e

custom_refstring

Custom reference number assigned by the seller

api_keystring

Internal API key used by the scraper. Example: 54bb0281238b45a03f0ee695f73e704f

GES_stringstring

Greenhouse gas emissions (GES) label as displayed on Leboncoin (e.g. A, B, C). Example: A

GESstring

Greenhouse gas emissions (GES) rating object. Example: a

DPE_stringstring

Energy Performance Diagnostic (DPE) label as displayed on Leboncoin (e.g. A, B, C). Example: B

DPEstring

Energy Performance Diagnostic (DPE) rating object. Example: b

room_countinteger

Total number of rooms in the property. Example: 5

sleepingroom_countinteger

Number of bedrooms in the property

charges_includedboolean

Whether service charges (charges) are included in the listed price. Example: true

areainteger

Living surface area of the property in square metres. Example: 105

floorinteger

Floor level of the property

price_per_square_meterfloat

Calculated price per square metre

furnishedboolean

Whether the property is furnished. Example: true

real_estate_typestring

Type of real estate (e.g. apartment, house, land). Example: Maison

detailstext

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_detailstext

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 %"}

functionsstring

Additional enrichment functions enabled for this record. Example: {"phone": {"filling_date": "09/30/2025, 14:21:24 +0200"}}

latstring

Latitude coordinate of the listing location. Example: 43.5237

lngstring

Longitude coordinate of the listing location. Example: 5.2578

ad_typestring

Type of advertisement on Leboncoin (offer or request). Example: offer

no_salesmenboolean

Whether the listing is from a private seller only (no professionals). Example: false

hash_valuestring

Internal hash used to identify this listing version. Example: e3d8cc836e81c6a2488f8871f8d4502f

Seller Profile Fields

Enriched seller profile data:

seller_registered_atstring

Date the seller's Leboncoin account was created (YYYY-MM-DD). Example: 2019-03-15

seller_reply_rateinteger

Percentage of messages answered by the seller (0–100). Example: 87

seller_reply_time_textstring

Typical reply time as a human-readable string. Example: 10 minutes

seller_presence_statusstring

Current online presence status of the seller. Values: ONLINE, OFFLINE

seller_presence_last_activitydatetime

Timestamp of the seller's last activity on Leboncoin. Example: 2025-07-04T03:45:00Z

seller_badgesstring

JSON array of badge names awarded to the seller (e.g. Responsiveness, RecommendedSeller, VerifiedPhoneNumber)

seller_total_adsinteger

Total number of active listings the seller currently has on Leboncoin. Example: 12

seller_feedback_scoresstring

JSON object with seller feedback scores per category: COMMUNICATION, PACKAGE, PRODUCT, RECOMMENDATION, USER_ATTENTION

seller_profile_picture_urlstring

URL of the seller's Leboncoin profile picture (medium resolution). Example: https://static.leboncoin.fr/img/user/...

seller_descriptionstring

Bio or description text written by the seller on their Leboncoin profile

Vehicle Fields

Vehicle-specific fields (cars, motorbikes, utilities):

mileageinteger

Vehicle mileage in km. Example: 45000

regdatestring

Vehicle model year. Example: 2021

fuelstring

Fuel type. Example: Essence

gearboxstring

Gearbox type. Example: Automatique

critairstring

Crit'Air environmental sticker rating for the vehicle. Example: 1

issuance_datestring

Vehicle first registration date. Example: 06/2021

conditionstring

Item condition (consumer goods). Example: Très bon état

brandstring

Vehicle brand/make. Example: Renault

modelstring

Vehicle model name. Example: Clio

vehicule_colorstring

Vehicle color. Example: Blanc

doorsinteger

Number of doors (cars). Example: 5

seatsinteger

Number of seats. Example: 5

horse_power_dininteger

DIN horsepower. Example: 90

horse_powerinteger

Fiscal horsepower (CV). Example: 6

cubic_capacityinteger

Engine displacement in cc (motorbikes). Example: 650

cycle_typestring

Motorcycle type. Example: Roadster

cycle_licencestring

Motorcycle licence category. Example: A

Response

200
{
  "total_results": 1,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "result_from": 1,
  "result_to": 1,
  "data": [
    {
      "id": 94856,
      "object": "result",
      "squid": "bb9c28c8c7700ca7138d26690c451595",
      "run": "57a01c9669db5f0d7900703b3876ecf1",
      "annonce_id": "3066299454",
      "title": "Villa 5 pièces 105 m²",
      "price": 1669,
      "url": "https://www.leboncoin.fr/ad/locations/3066299454",
      "description": "Villa 5 pièces 105 m²\n\nDans bel environnement, A LOUER VELAUX, Villa meublée type 5 d'une surface habitable de 104,89 m² sur terrain de 1100 m².\nRDC :  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.\n1er étage : une chambre en mezzanine.\nTerrasse - Garage/buanderie - \nClimatisation réversible.\n\nDisponible le 26/10/2025\n\nSurface : 105 m²\nLoyer : 1669 € / mois (charges comprises)\nMontant des charges : 275 € / mois\nModalité de récupération des charges locatives : Prévisionnelles mensuelles avec régularisation annuelle\nHonoraires à la charge du locataire : 1363.57 € dont 314.67 € pour l'état des lieux\nDépôt de garantie : 1394 €\nDate de réalisation du diagnostic énergétique : 23/08/2023\n\nConsommation énergie primaire : 105 kWh/m²/an\nConsommation énergie finale : Non communiqué\n\nMontant 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)\n\nLes informations sur les risques auxquels ce bien est exposé sont disponibles sur le site Géorisques : www.georisques.gouv.fr",
      "mail": null,
      "pictures": "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": false,
      "picture": "https://img.leboncoin.fr/api/v1/lbcpb1/images/84/bc/c2/84bcc22c34147d593b771914b7db7b9791c71c3c.jpg?rule=ad-large",
      "category_name": "Locations",
      "currency": "EUR",
      "region": "Provence-Alpes-Côte d'Azur",
      "department": "Bouches-du-Rhône",
      "city": "Velaux",
      "city_label": "Velaux 13880",
      "postal_code": "13880",
      "is_exclusive": null,
      "is_boosted": false,
      "first_publication_date": "2025-09-29T12:33:03+00:00",
      "last_publication_date": "2025-09-29T12:33:03+00:00",
      "expiration_date": null,
      "has_phone": true,
      "status": null,
      "is_mobile": null,
      "phone": "0442747158",
      "phone_from_user": null,
      "has_online_shop": true,
      "online_shop_url": "https://www.leboncoin.fr/boutique/21494",
      "owner_type": "1",
      "owner_name": "A C D IMMOBILIER VILLAGE",
      "user_id": "5e25f2ef-d2b7-4694-a321-e7a992df327e",
      "custom_ref": null,
      "api_key": "54bb0281238b45a03f0ee695f73e704f",
      "GES_string": "A",
      "GES": "a",
      "DPE_string": "B",
      "DPE": "b",
      "room_count": 5,
      "sleepingroom_count": null,
      "charges_included": true,
      "area": 105,
      "floor": null,
      "price_per_square_meter": null,
      "furnished": true,
      "real_estate_type": "Maison",
      "details": "{\"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": "{\"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": null,
      "lat": "43.5237",
      "lng": "5.2578",
      "ad_type": "offer",
      "no_salesmen": false,
      "hash_value": null,
      "seller_registered_at": "2021-02-02",
      "seller_reply_rate": 100,
      "seller_reply_time_text": "10 minutes",
      "seller_presence_status": "OFFLINE",
      "seller_presence_last_activity": "2026-06-10T15:53:13+00:00",
      "seller_badges": "[\"Responsiveness3\", \"VerifiedPhoneNumber\"]",
      "seller_total_ads": 12,
      "seller_feedback_scores": "{\"COMMUNICATION\": 1, \"PACKAGE\": 1, \"PRODUCT\": 1, \"RECOMMENDATION\": 1, \"USER_ATTENTION\": 1}",
      "seller_profile_picture_url": "https://img.leboncoin.fr/api/v1/tenants/.../images/profile/pictures/default/f7c839c3.jpg?rule=pp-medium",
      "seller_description": null,
      "mileage": null,
      "regdate": null,
      "fuel": null,
      "gearbox": null,
      "critair": null,
      "issuance_date": null,
      "condition": null,
      "brand": null,
      "model": null,
      "vehicule_color": null,
      "doors": null,
      "seats": null,
      "horse_power_din": null,
      "horse_power": null,
      "cubic_capacity": null,
      "cycle_type": null,
      "cycle_licence": null,
      "native_id": 94856
    }
  ],
  "next": null,
  "previous": null
}