Piloterr

Leboncoin Ad

Extract full details from a Leboncoin ad including price, location, attributes, seller info, and images.

Credit cost: 1 credit per call

GET
/v2/leboncoin/ad

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Leboncoin ad ID or full ad URL.

Accepted formats:

  • Ad ID: 2715494476
  • Full URL: https://www.leboncoin.fr/voitures/2715494476.htm

Example:

https://www.leboncoin.fr/voitures/2715494476.htm

Note: The ad must be currently active on Leboncoin. Expired or deleted ads return an error.

return_page_source?boolean

Set to true to include the full raw HTML source of the ad page in the response.

Use case: Useful for advanced data extraction or debugging when the structured response does not include all desired fields.

Default"false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/leboncoin/ad?query=string"
{
  "list_id": 2715494476,
  "category": {
    "id": "2",
    "label": "Voitures"
  },
  "subject": "Renault Clio IV 1.5 DCI 90 Energy SL Rip Curl",
  "body": "Renault Clio IV 1.5 DCI 90. Carnet d'entretien complet, CT OK, première main.",
  "price": [
    8500
  ],
  "price_cents": [
    850000
  ],
  "owner": {
    "type": "private",
    "name": "Jean-Marc",
    "user_id": "abc123456",
    "siren": null
  },
  "location": {
    "city": "Bordeaux",
    "zipcode": "33000",
    "department_id": "33",
    "department_name": "Gironde",
    "region_id": "14",
    "region_name": "Nouvelle-Aquitaine",
    "lat": 44.8378,
    "lng": -0.5792
  },
  "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"
    }
  ],
  "images": {
    "urls": [
      "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1234567890.jpg"
    ]
  },
  "creation_date": "2024-09-15T14:22:00+02:00",
  "expiration_date": "2024-10-15T14:22:00+02:00",
  "status": "active",
  "url": "https://www.leboncoin.fr/voitures/2715494476.htm"
}
{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}