# Leboncoin Search API

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `POST` |
| **Endpoint** | `/v2/leboncoin/search_api` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/leboncoin-search_api |

## Description

Search Leboncoin listings via structured POST API with advanced filters for category, location, price range, seller type, and sorting.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request POST 'https://api.piloterr.com/v2/leboncoin/search_api' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Volkswagen Golf car listings

```json
{
  "ads": [
    {
      "url": "https://www.leboncoin.fr/voitures/2712345678.htm",
      "body": "Bonjour, je vends ma Golf 7 en parfait état, CT valable, aucun défaut.",
      "owner": {
        "name": "Lucas",
        "type": "private",
        "siren": null
      },
      "price": [
        11500
      ],
      "images": {
        "urls": [
          "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1.jpg"
        ],
        "nb_images": 6,
        "small_url": "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1.jpg",
        "thumb_url": "https://img.leboncoin.fr/api/cdn/thumbs/abcdef1_thumb.jpg"
      },
      "status": "active",
      "ad_type": "classified",
      "list_id": 2712345678,
      "subject": "Volkswagen Golf VII 1.6 TDI 110 Confortline Business",
      "currency": "EUR",
      "location": {
        "lat": 45.75,
        "lng": 4.85,
        "city": "Lyon",
        "zipcode": "69003",
        "region_id": "22",
        "country_id": "FR",
        "region_name": "Auvergne-Rhône-Alpes",
        "department_id": "69",
        "department_name": "Rhône"
      },
      "attributes": [
        {
          "key": "regdate",
          "value": "2017",
          "value_label": "2017"
        },
        {
          "key": "mileage",
          "value": "112000",
          "value_label": "112 000 km"
        },
        {
          "key": "fuel",
          "value": "diesel",
          "value_label": "Diesel"
        },
        {
          "key": "gearbox",
          "value": "manual",
          "value_label": "Manuelle"
        },
        {
          "key": "brand",
          "value": "volkswagen",
          "value_label": "Volkswagen"
        },
        {
          "key": "model",
          "value": "Golf VII",
          "value_label": "Golf VII"
        },
        {
          "key": "critair",
          "value": "2",
          "value_label": "Crit'Air 2"
        }
      ],
      "brand_name": null,
      "category_id": "2",
      "price_cents": [
        1150000
      ],
      "category_name": "Voitures",
      "creation_date": "2024-09-10T11:00:00+02:00",
      "expiration_date": "2024-10-10T11:00:00+02:00"
    }
  ],
  "total": 4821,
  "max_pages": 100,
  "total_all": 4821,
  "total_pro": 1203,
  "total_private": 3618
}
```

## Documentation

## Overview
Query Leboncoin's internal search API via POST with advanced filters for category, location, price, seller type, and sorting.

## Quickstart
```
POST https://api.piloterr.com/v2/leboncoin/search_api
{ "filters": {"category": {"id": "2"}, "keywords": {"text": "volkswagen golf"}} }
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `filters` | object | yes | Search filters |
| `owner_type` | string | no | `all`, `pro`, `private` |
| `limit` | integer | no | Max 35 |
| `offset` | integer | no | For pagination |

## Main use cases
- Build systematic classifieds data pipelines
- Track market prices for specific makes/models
- Monitor new listings to trigger alerts
- Competitive analysis on French classifieds