Piloterr

Leboncoin Ad

GET
/v2/leboncoin/ad

Extract full details from a Leboncoin ad including price, location, attributes, seller info, and images. Returns structured JSON by default, or raw HTML on demand.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Leboncoin ad ID or full ad URL. Both formats are accepted regardless of return_page_source.

Accepted formats:

  • Ad ID: 3012186547
  • Full URL: https://www.leboncoin.fr/ad/equipement_auto/3012186547

Examples:

3012186547
https://www.leboncoin.fr/ad/equipement_auto/3012186547

Note: If the ad has been deleted or expired on Leboncoin, the endpoint returns a 404 status code.

return_page_source?boolean

Controls the response format.

  • false (default): returns a structured JSON object with all parsed ad fields (price, location, attributes, seller, images, etc.).
  • true: returns the raw HTML source of the ad page as a string. Useful for advanced extraction or debugging when a field is missing from the structured response.

Note: The same query (ad ID or full URL) works in both modes. You don't need to change the input format depending on the value of this parameter.

Default"false"

Response Body

Successful response

application/json
  1. response
url?string
body?string
owner?
price?array<integer>
images?
status?string
list_id?integer
subject?string
category?
location?
attributes?array<>
price_cents?array<integer>
creation_date?string
expiration_date?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/leboncoin/ad?query=string'
Example Response
{  "url": "https://www.leboncoin.fr/voitures/2715494476.htm",  "body": "Renault Clio IV 1.5 DCI 90. Carnet d'entretien complet, CT OK, première main.",  "owner": {    "name": "Alex Martin",    "type": "private",    "siren": null,    "user_id": "abc123456"  },  "price": [    8500  ],  "images": {    "urls": [      "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1234567890.jpg"    ]  },  "status": "active",  "list_id": 2715494476,  "subject": "Renault Clio IV 1.5 DCI 90 Energy SL Rip Curl",  "category": {    "id": "2",    "label": "Voitures"  },  "location": {    "lat": 44.8378,    "lng": -0.5792,    "city": "Bordeaux",    "zipcode": "33000",    "region_id": "14",    "region_name": "Nouvelle-Aquitaine",    "department_id": "33",    "department_name": "Gironde"  },  "attributes": [    {      "key": "regdate",      "value": "2015",      "value_label": "2015"    },    {      "key": "mileage",      "value": "95000",      "value_label": "95 000 km"    },    {      "key": "fuel",      "value": "diesel",      "value_label": "Diesel"    },    {      "key": "gearbox",      "value": "manual",      "value_label": "Manuelle"    },    {      "key": "horsepower",      "value": "8",      "value_label": "8 CV"    },    {      "key": "brand",      "value": "renault",      "value_label": "Renault"    },    {      "key": "model",      "value": "Clio IV",      "value_label": "Clio IV"    },    {      "key": "vehicle_damage",      "value": "no_damage",      "value_label": "Non endommagé"    },    {      "key": "seats",      "value": "5",      "value_label": "5 places"    },    {      "key": "doors",      "value": "5",      "value_label": "5 portes"    },    {      "key": "critair",      "value": "2",      "value_label": "Crit'Air 2"    },    {      "key": "color",      "value": "silver",      "value_label": "Gris"    },    {      "key": "vehicle_type",      "value": "berline",      "value_label": "Berline"    }  ],  "price_cents": [    850000  ],  "creation_date": "2024-09-15T14:22:00+02:00",  "expiration_date": "2024-10-15T14:22:00+02:00"}